home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 31 / Amiga Format CD31 (1998-09-02)(Future Publishing)(GB)(Track 1 of 2)[!][issue 1998-10].iso / -seriously_amiga- / sound / aplayer / files / docs.lha / APlayer.guide (.txt) next >
Amigaguide Document  |  1997-06-07  |  222KB  |  4,247 lines

  1. @database AccessiblePlayer.guide
  2. @Author Jakob Langgaard
  3. @INDEX INDEXNODE
  4. @Master APlayer.guide
  5. @Node Main "Root"
  6. @TITLE "AccessiblePlayer V2.22 Copyright 
  7.  Access 1994-1996"
  8.      Welcome to the Amigaguide
  9. d world of AccessiblePlayer:
  10.      @{b}Please read the future section this time, since this is the last
  11.      Amiga version of APlayer .. @{ub}
  12.      @{" Future           " LINK Future}    The future for APlayer ..
  13.      Please select one of the following topics:
  14.      @{" Featurelist      " LINK Features} @{b}   List of cool features
  15.      @{" Disclaimer       " LINK Disclaimer}    Legal Information
  16.      @{" Registration     " LINK shareware}    How to register
  17.      @{" Requirements     " LINK Requirements}    What you need
  18.      @{" Introduction     " LINK Introduction}    Introduction to APlayer
  19.      @{" How to Install   " LINK Installation}    How to install APlayer
  20.      @{" ToolTypes/CLI    " LINK Tooltypes}    Tooltypes and CLI arguments
  21.      
  22.      @{" How to use       " LINK Usage}    How to use APlayer
  23.      @{" Keyboard control " LINK keyboard}    How to control APlayer with the keyboard
  24.      @{" Module Types     " LINK ModTypes}    Module types supported by APlayer
  25.      @{" ARexx            " LINK Arexxmain}    How to use ARexx with APlayer
  26.      
  27.      @{" Programmers      " LINK /Developer/Libraries.doc/MAIN}    Coders, read this
  28.      @{" Thanks to        " LINK Thanks}    I want to thank my producer, and mom & dad...
  29.      @{" History          " LINK History}    The history of APlayer
  30.      @{" Contact          " LINK contact}    We want you NOW!@{ub}
  31. @ENDNODE
  32. -------------------------------------------------------------------------------
  33. @NODE Features
  34. @TITLE "The Featurelist of AccessiblePlayer"
  35.   @{b}@{u}Special APlayer Features:@{ub}@{uu}
  36.  - Own homepage - new and improved: http://home6.inet.tele.dk/jail/
  37.  - Supports 68 different @{"module formats" LINK modtypes}.
  38.  - Supports OctaMED Sound Studio - @{b}We were the first!!!@{ub}
  39.  - Supports Impulse, S3M, Fasttracker I & II, Multitracker and more.
  40.  - Sports AHI - Audio Hardware Interface - by Martin Blom
  41.    That is sound card support ..
  42.  - Uses noteplayers. AHI, Stereo, 14 bit, surround, fastmem player ...
  43.  - Agent Interface
  44.  including, from v2.00, @{b}Graphical Scopes!@{ub}
  45.  - @{"Online Help" LINK OnlineHelp} (Press Help  while placing your pointer on the function you
  46.    want help for).
  47.  - @{b}WHY@{ub} requesters. If you get an error requester from APlayer and you don't
  48.    understand what's going on, press the WHY gadget in the requester.  This
  49.    gives  you  a  brief description of the error, and suggestions on how to
  50.    correct it.
  51.  - Recognizes  and  unpacks   179  different   cruncher  types  (using  the
  52.    @{"Unpack.library" LINK cfgunpack}).
  53.  - @{"Favourite Song System
  54. " LINK FSS}
  55.    @{b}No one else does this!!@{ub}
  56.  - @{"Play samples" LINK sampleinfo} by the keyboard while listening to the module.
  57.    This now includes a multikeyboard function (press "DEL").
  58.    The number of channels used depends of the module, so if you hear  a  16
  59.    channels S3M module you can play in multi mode with 16 CHANNELS!!!!
  60.    @{b}We were the first@{ub}
  61.  - @{"Save samples" LINK sampleinfo} can be used to rip  your favourite  samples, even  if  you
  62.    don't own the actual music program. This also works with S3M, XM a.s.o.
  63.    @{b}No one else does this!!@{ub}
  64.  - Can convert/save samples between different formats like IFF-8SVX,
  65.    IFF-AIFF, Raw, RIFF-WAVE and .. @{"Worms" LINK multimods} sample banks.
  66.  - Can play modules from Fast memory, saving your sparesome Chip memory.
  67.  - @{"App-Icon" LINK app-icon} and App-window, that means full support for Dopus5 drag'n'drop!.
  68.  - Full commodity interface. Depending on your @{"system" LINK Requirements}.
  69.  - Supports @{"Lha/Lzx files" LINK cfgunpack}, including extract pattern.
  70.  - Supports @{"Public Screens" LINK cfgwindowsscreens}.
  71.  - Make your own favourite lists of modules with the @{"APML
  72. " LINK ML} system.
  73.  - @{"Early load" LINK cfgOptions} system which kills the waiting time between the modules.
  74.    @{b}We were the first!!@{ub}
  75.  - @{"ARexx interface" LINK Arexxmain}
  76.  - And much, much more...
  77. @ENDNODE
  78. -------------------------------------------------------------------------------
  79. @NODE Future
  80. @TITLE "The Future of APlayer"
  81.   @{b}@{u}The Future of APlayer:@{ub}@{uu}
  82.   The future of APlayer is the BeOS (www.be.com) and perhaps the PC ..
  83.   Thomas has bought a PowerPC (603e 200 MHz :9  and is planning to port
  84.   APlayer.
  85.   Because of this, and because someone suggested it, we have decided to
  86.   release this final version as a @{b}non-crippled shareware@{ub} version.
  87.   You can still register if you don't want the about window to read
  88.   "unregistered", but your name instead. But otherwise it's up to yourself
  89.   to register :)
  90.   We want to thank all the people who has supported us in the development
  91.   of APlayer - thank you! (this includes the few registered ones ;)
  92.   We hope to see you somewhere in the future - don't worry, be happy! ..
  93. @ENDNODE
  94. -------------------------------------------------------------------------------
  95. @NODE Disclaimer
  96. @TITLE "Copyright information and rules of distribution"
  97.   @{b}@{u}Copyright information:@{ub}@{uu}
  98.   AccessiblePlayer is now @{"Shareware" LINK Shareware}.  However  parts  of  the  APlayer  is
  99.   copyright by  other people  (the external players). Whereever possible we
  100.   have tried to make sure  that  no  parts  of  the  APlayer  violates  any
  101.   copyrights.  If  you  think  this  is  not  the  case,  please contact us
  102.   immediately!
  103.   If you or your company  want to use APlayer on  a coverdisk  or something
  104.   like that, we would like to know about it, and get a copy of the product.
  105.   And  since  RBF  Software  wants us  to do this, we must  write that  the
  106.   OctaMED and MED players are copyrighted by them.
  107.   @{b}Although this program is SW, you  are  welcome  to  send  anything,  like
  108.   money, ski masks, postcards,  cars, Subway sandwich'es (preferably pizza-
  109.   subs :), Kinder M
  110. lkesnitte etc.@{ub}
  111. @ENDNODE
  112. -------------------------------------------------------------------------------
  113. @NODE Shareware
  114. @TITLE "Shareware Notice"
  115.   @{b}@{u}Shareware Payment:@{ub}@{uu}
  116.   Everything has a price .. even APlayer :) :(
  117.   @{b}APlayer is now non-crippled shareware!!!@{ub}
  118.   If you register, you will also get your name in the about window :)
  119.   @{b}IMPORTANT:@{ub}
  120.   If you register, you will only register the MAIN program. All the players
  121.   and  noteplayers  are  still  public domain. We can't make money on other
  122.   peoples work :)
  123.   @{b}How To Register:@{ub}
  124.   @{i}No matter how you register, you will have to fill  out  the  registration
  125.   form and send it to us together with your registration.@{ui}
  126.   1. Cash Registration
  127.      You can send cash directly to the author in two different currencies:
  128.      100 Dkr (Danish Kroner)
  129.      25 US Dollars (Due to the exchange price)
  130.      Send them to:
  131.      @{b}Thomas Neumann
  132.      Reb
  133. park 3, 7 sal, v
  134. r. 710
  135.      2650 Hvidovre
  136.      Denmark@{ub}
  137.   2. Eurocheck
  138.      If you live in europe you can just use an eurocheck or another type of
  139.      check which will not cost us anything to cash. The amount is:
  140.      100 Dkr (Danish kroner)  eq. to 10 UK Pound or 25 DM
  141.      If your bank won't write the check in  Dkr,  then  you  should  add  5
  142.      pounds (12 DM) extra for the exchange fee.
  143.      Send them to: See above
  144.   3. NET registration (Idea taken from the GoldED package)
  145.      This is the easiest way to register. You can  send  an  email  to  the
  146.      email  address  below.  Then  you  can deposit the money direct on the
  147.      author's account (this can be done in any bank).
  148.      You will then recieve an E-mail with an UUencoded keyfile.
  149.      Send the letter to:
  150.      tneumann@usa.net
  151.      or
  152.      jail@diku.dk
  153.      and transfer the money (100 Dkr) to this account within two weeks (you
  154.      will not get the keyfile before we recieve the money):
  155.      @{b}Thomas Neumann
  156.      Account number: 0156 5362254118
  157.      Unibank
  158.      R
  159. dovre Stations Center
  160.      2610 R
  161. dovre
  162.      Denmark@{ub}
  163. @ENDNODE
  164. -------------------------------------------------------------------------------
  165. @NODE Requirements
  166. @TITLE "Hard'n'soft-ware requirements"
  167.   @{b}@{u}Hard'n'soft-ware requirements:@{ub}@{uu}
  168.   You need at least kickstart v2.04 to use this program.
  169.   Four  general libraries  are  necessary  to  run  the  APlayer  with  all
  170.   functions.  APlayer  cannot  start  without  the  Reqtools.library (v38+)
  171.   (included)   and   any  version  of  the  Diskfont.library.  But  if  the
  172.   commodities.library  isn't  available,  it  will  just  not  start  as  a
  173.   commodity (this means that you can't use the hotkeys). Amigaguide.library
  174.   is needed if you want online help for APlayer.
  175.   If you want the APlayer to unpack your modules, you should use one of the
  176.   following libraries: Xpkmaster.library or the Unpack.library.
  177.   All of them are included in this package though.
  178.   To make use of the ARexx part of APlayer you need  the  Rexxtools.library
  179.   which is included in the package.
  180.   The APlayer has been successfully tested on the following machines:
  181.   A1200+68030+4MB  Fastram, A4000(68040)+16MB  Fastram and an A4000(68060)+
  182.   16MB Fastram including tests with Enforcer, Mungwall and IOtorture.
  183. @ENDNODE
  184. -------------------------------------------------------------------------------
  185. @NODE Introduction
  186. @TITLE "Introduction to AccessiblePlayer"
  187.   @{b}@{u}Introduction:@{ub}@{uu}
  188.   The AccessiblePlayer is our contribution to the  Amiga  market  of  music
  189.   players.  We  thought  that  our favourite player (Smartplay) just wasn't
  190.   good enough anymore, and since none  of  the  available  players  (D.A.S.
  191.   Modplayer,  Delitracker,  HippoPlayer,  BananaPlayer, EagleTracker and so
  192.   on) fulfilled our needs, we decided to write our own player.
  193.   We hope we have reached our goal by making a small, fast and userfriendly
  194.   player, the AccessiblePlayer.
  195. @ENDNODE
  196. -------------------------------------------------------------------------------
  197. @NODE Installation
  198. @TITLE "Installing the AccessiblePlayer"
  199.   @{b}@{u}Installation:@{ub}@{uu}
  200.   Just  use  the  installer-script  included  in this package. You can both
  201.   install AND remove (who would?) the APlayer with that script.
  202.   @{b}Warning:@{ub} APlayer is pretty complex to  install, so if you want to install
  203.            it by hand, don't blame us if something goes wrong.
  204.            In other words: @{i}"Don't try this at home"@{ui}
  205. @ENDNODE
  206. -------------------------------------------------------------------------------
  207. @{ub}
  208. @Font topaz.font 8
  209. @NODE Usage
  210. @TITLE "How to use AccessiblePlayer"
  211.   @{b}@{u}The Accessible Interface:@{ub}@{uu}
  212.    -----------------------------------------------------------------------
  213.    | 
  214.  |  AccessiblePlayer 2.22                          @{"(1/1)" LINK tunes}          |
  215.    |----------------------------------------------------------------------
  216.    |@{" Cycle gadget  " LINK MainCyc}@{"                 Status bar                 " LINK Status}@{" S " LINK Sampleinfo}@{" ? " LINK About}|
  217.    |----------------------------------------------------------------------
  218.    |@{"_
  219. " LINK Volreset}@{" Volume Slider " LINK Volume}|                                           |    |
  220.    |--------------------|                                           |    |
  221.    |@{" 
  222. >" LINK SReset}@{"  Speed Slider " LINK Speed}|            @{" Main Listview " LINK mainListview}               |@{" | " LINK scroll}|
  223.    |--------------------|                                           |    |
  224.    |@{" 1 2 3 4 " LINK 1}@{" [] " LINK Loop}@{"^v^v" LINK Shuffle}|                                           |    |
  225.    |----------------------------------------------------------------------
  226.    |@{" ICN" LINK Icn}@{" CFG" LINK Cfg}@{" FSS" LINK FSS}@{" ML " LINK ML}@{"  |<  " LINK Prev}@{"  <<  " LINK Rew}@{"   >  " LINK Play}@{"  >>  " LINK FF}@{"  >|  " LINK Next}@{"   ^  " LINK Eject}@{"  ||  " LINK Pause}|
  227.    -----------------------------------------------------------------------
  228.   @{b}App-Window@{ub}: The   main  window  of  APlayer  can  be  used  for  dropping
  229.               module-icons.  The names of the modules will automatically be
  230.               added  to  the  end  of the modulelist. See also @{"App-Icon" LINK App-icon}.
  231.   @{b}The Zoom Gadget@{ub} can be used to zip the program window.  The  main  window
  232.   will  be  zipped  to the titlebar only. Notice that the placement will be
  233.   saved in the configuration file.
  234. @ENDNODE
  235. -------------------------------------------------------------------------------
  236. @Font screenfont 8
  237. @Node Maincyc
  238. @TITLE "Main window cycle"
  239.   @{u}@{b}Main window cycle:@{ub}@{uu}
  240.   This cyclegadget is used to select the state of the @{"status-bar" LINK status}.
  241.   There are five different states of this cycle, which are:
  242.   @{b} Name   : @{ub}
  243.     This shows the name of the module, which is found IN the module. e.g it
  244.     is  not  necessarily  the  name  of  the  file, so the two names can be
  245.     different; that is, if the player can't find a name inside the  module,
  246.     the filename will be displayed in the @{"status bar" LINK Status}.
  247.   @{b} Author : @{ub}
  248.     The player tries to find the name of the author in the module,  and  if
  249.     it  succeeds, it  will display it in the statusline. See in the section
  250.     @{"Module types" LINK modtypes} for info on which players  support the  author  name.
  251.   @{b} Played : @{ub}
  252.     This  shows,  if supported (see @{"Module types" LINK modtypes}), the actual position and
  253.     the  total  songlength.  It  also  calculates  how many % of the module
  254.     that has been played, and the total listening time.
  255.   @{b} Type   :@{ub}
  256.     When  the  module has been tested, the @{"module type" LINK modtypes} is displayed in the
  257.     status-line.  This  could be anything from the SID-player to the TFMX 7
  258.     channel replayer.
  259.   @{b} RexxMsg:@{ub}
  260.     This displays info text made by an @{"Arexx" LINK ARMAINCYCLE} script.
  261. @ENDNODE
  262. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  263. @Node Status
  264. @TITLE "Status bar"
  265.   @{u}@{b}Status Bar:@{ub}@{uu}
  266.   This  line will display some info on the current module.  It will display
  267.   the name, author, playing time, module type and rexx message.
  268.   See @{"Main window cycle" LINK mainCyc} on how to change the state.
  269. @ENDNODE
  270. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  271. @Node SampleInfo
  272.   @{u}@{b}Sample info window:@{ub}@{uu} (Shortkey s)
  273.   Pressing  the @{b}S@{ub}-Button will, if samples are supported (see @{"module types" LINK modtypes})
  274.   open a new  window called the sampleinfo  window. The samples are  always
  275.   saved in signed IFF-8SVX format.
  276.   From left to right it will display the number of the sample,  name,  size
  277.   in  bytes,  type  of  the  sample  and  whether  it's  placed in chip- or
  278.   fast-memory.
  279.   The sample can be of these different types:
  280.   XX - it means that it's a sample with the sample bit XX.
  281.   AM - Synthetic voices (Amplitude Modulation)
  282.   FM - Precalculated synthetic voices (Frequency Modulation)
  283.   HB - Sample used as a synthetic voice (HyBrid)
  284.   AL - AdLib sound used in S3M modules
  285.   WS - WaveSample. Same as hybrid samples, but these  can be played in  the
  286.        sample window. Used in Art of Noise.
  287.   ?? - Unknown type
  288.   -- - No sample
  289.   If the type is typed in @{b}bold@{ub} it means that the sample is unsigned.
  290.   The sampleinfo window is not only a display/info window, you can actually
  291.   use it to accompany your favourite modules. You can do it in two ways:
  292.   @{b}1@{ub}. Pause  the  module  (in  the  main  window) and use your mouse, or the
  293.      @{"keypad" LINK Keypad},  to  select a sample. Then you can use your keyboard (like in
  294.      Protracker) to play the sample at different notes, ranging from C-1 to
  295.      B-3.  Like  in  protracker you can use F1 and F2 to change whether the
  296.      z-key  should  be a C-1 (default) or a C-2 note. Note that if a sample
  297.      has the volume set to 0, then it will be played with a value of 64.
  298.   @{b}2@{ub}. Turn off one  of the @{"sound-channels" LINK 1} and, like before, choose a sample
  299.      with the @{"keypad" LINK Keypad} or with the mouse. Then use the keyboard to accompany
  300.      the module.
  301.   @{b}Multichannel Mode:@{ub}
  302.      Per default  APlayer will only play  the sample in one channel. But if
  303.      you   press  "DEL"   (the  Delete  key)   in  the  sampleinfo  window,
  304.      multichannel mode will be enabled.
  305.      If you are in pause mode, all the channels  which are ON will be used.
  306.      If  you are  using the  accompany  function, the  OFF  turned channels
  307.      will be used to play the samples.
  308.      Please note that the number of channels used is  dependant of the used
  309.      Player.
  310.   The last function in the sampleinfo window is the little  disk-gadget  in
  311.   the upper right corner of the window. Selecting a sample and pressing the
  312.   disk-gadget will open a requester which will let you save the  sample  as
  313.   an  8SVX  soundfile with the samplerate 16574 (in pal) or 16726 (in ntsc)
  314.   which is the C-3 note. Pressing "return" will do the same.
  315.   If you have the @{"Multi Sample Saver Agent" LINK multi} present in  your agent list, it
  316.   will pop up to give you much more options on how to save the sample
  317.   Instead of using the keypad or the mouse, you can use the @{"keyboard" LINK listview}.
  318.   If you want to stop the playing sample NOW! then  you  can  hit  the  "<"
  319.   which is placed on the right side of the left shift key.
  320.   @{b}NOTE: Not  all players support  the sample info window, and therefore not
  321.         the  sample-save  and  accompany  functions. (see @{"Module types" LINK modtypes} for
  322.         more info)@{ub}
  323. @ENDNODE
  324. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  325. @Node Keypad
  326.   @{u}@{b}Numeric Keypad:@{ub}@{uu}
  327.   This  works  exactly  like in @{"QuadraComposer" LINK Thanks}. Sample 1-16 is chosen from
  328.   the  upper  left corner on the numpad to the lower right corner, which is
  329.   the Enter-key. @{b}"0"@{ub} is used to jump forward 16 samples, and @{b}"."@{ub} to go back
  330.   to the previous 16 samples.
  331.   Note that pressing a keypad key, will trigger the sample at the note C-3.
  332.   And that is not changeable yet, sorry!
  333.   Note that if a sample has the volume set to 0, then  it  will  be  played
  334.   with a value of 64.
  335. @ENDNODE
  336. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  337. @Node About
  338.   @{u}@{b}About Window:@{ub}@{uu} (Shortkey ?)
  339.   This will open a window containing some info on the current module:
  340.     @{b}Module name           :@{ub} The name of the module.
  341.     @{b}Author                :@{ub} The author of the module.
  342.     @{b}Active Player         :@{ub} The Player-library which is used now.
  343.     @{b}Active NotePlayer     :@{ub} The actual NotePlayer.
  344.     @{b}Number of tunes       :@{ub} Number of @{"tunes" LINK tunes} in the module.
  345.     @{b}Song Length           :@{ub} How long is this module, songpositions.
  346.     @{b}Used Patterns         :@{ub} How many different patterns are used.
  347.     @{b}Supported/Used samples:@{ub} The  number of used or supported samples e.g. a
  348.                             Protracker  module  will always use 31 samples,
  349.                             while  a  QComposer  uses  a  various number of
  350.                             samples.
  351.     @{b}Used Channels         :@{ub} The number of channels in the actual module.
  352.     @{b}Used Mixing rate      :@{ub} This  will, if a NotePlayer  is mixing, display
  353.                             the actual mixing rate.
  354.     @{b}Actual Speed          :@{ub} This  is  only  useful  for  players supporting
  355.                             cia-speed commands (like Protracker).
  356.     @{b}Module Size           :@{ub} The size of the unpacked module.
  357.   @{b}NOTE: A lot of the above-mentioned parameters is not supported by all the
  358.         players.  See  @{"module types" LINK modtypes}  for  info on which players supporting
  359.         what, or try it out for yourself.@{ub}
  360.   The "next"-gadget will show you the version number, the  arexx-port  name
  361.   and the creditlist for the AccessiblePlayer.
  362.   You can use the "cancel"-gadget or <return> to go back to the main window
  363.   again.
  364. @ENDNODE
  365. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  366. @Node tunes
  367.   @{u}@{b}Tunes:@{ub}@{uu}
  368.   A module normally consists of 1 tune only, but players like SID and  TFMX
  369.   supports  more  tunes in one module. You can choose between the different
  370.   tunes using  the keys 1-9 and 0 for  10. Of course,  you can also use the
  371.   numeric keyboard. If there  are more than  10 tunes, you  may use "+" and
  372.   "-" to skip to the  next 10 tunes or to go back to the previous 10 tunes.
  373.   The only place where you can't do it is in the sample info window.
  374.   The "(x/y)" in the title bar shows "current tune/total number of tunes".
  375.   If you zip the window, this will instead show the position/length.
  376. @ENDNODE
  377. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  378. @Node Volreset
  379. @TITLE "Volume Reset"
  380.   @{u}@{b}Volume Reset:@{ub}@{uu}
  381.   Pressing  this  gadget will reset the volume to the default volume, saved
  382.   in your config-file (see @{"configuration" LINK cfg}). You can also use @{"keyboard" LINK keyboard}.
  383. @ENDNODE
  384. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  385. @Node Volume
  386. @TITLE "Adjust Volume"
  387.   @{u}@{b}Volume Adjusting:@{ub}@{uu}
  388.   This slider is used to boost or lower the volume of the player.  Remember
  389.   that the actual volume is saved with your configuration file!
  390.   You can also use @{"keyboard" LINK keyboard}.
  391.   See also @{"Volume reset" LINK volreset} and @{"Configuration" LINK cfg}
  392.   @{b}NOTE: Nearly all moduleplayers support this, but a few don't. See in the
  393.         @{"Module types" LINK modtypes} section for more info.@{ub}
  394. @ENDNODE
  395. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  396. @Node MainListview
  397. @TITLE "Main window list"
  398.   @{u}@{b}Main window module list:@{uu}@{ub}
  399.   This  displays  all  the  modules  currently  in the @{"module list" LINK modlist}. If you
  400.   choose  a  module  it will be highlighted. That is, the playing module is
  401.   always the one which is highlighted.
  402. @ENDNODE
  403. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  404. @Node Scroll
  405. @TITLE "Modulelist Scroller"
  406.   @{u}@{b}Modulelist Scroller:@{ub}@{uu}
  407.   Use this scrollbar to scroll through the @{"list of modules" LINK mainlistview}.
  408. @ENDNODE
  409. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  410. @Node Sreset
  411. @TITLE "Speed Reset"
  412.   @{u}@{b}Speed Reset:@{ub}@{uu}
  413.   Pressing  this gadget will reset the speed to the default value, saved in
  414.   your config-file. (See @{"configuration" LINK cfg}).
  415.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  416.   @{b}NOTE: Changing  of  speed  is  only  available  when  the player supports
  417.         cia-timing. (See @{"Module types" LINK modtypes})@{ub}
  418. @ENDNODE
  419. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  420. @Node Speed
  421. @TITLE "Adjust Speed"
  422.   @{u}@{b}Adjusting Speed :@{ub}@{uu}
  423.   This slider is used for changing the speed of the module.
  424.   Remember that the default speed is saved with your configuration file!
  425.   (See @{"Configuration" LINK cfg})
  426.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  427.   @{b}NOTE: Changing  of  speed  is  only  available  when  the player supports
  428.         cia-timing. (See @{"Module types" LINK modtypes})@{ub}
  429.   See also @{"Speed reset" LINK Sreset}.
  430. @ENDNODE
  431. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  432. @Node 1
  433. @TITLE "Sound Channels"
  434.   @{u}@{b}Sound Channels:@{ub}@{uu}
  435.   These 4 buttons are used to turn the amiga sound channels on or off. This
  436.   is used when you want to accompany the module.
  437.   (See the @{"Sampleinfo window" LINK sampleinfo}).
  438.   Please notice that these buttons indicate the  hardware  audio  channels,
  439.   which  means  that  if  a  noteplayer  is playing, pressing the channel 1
  440.   button can turn of upto 8 channels.
  441.   Ofcourse they can be used for fun too!
  442.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  443.   @{b}NOTE: It's  not  all moduletypes which supports turning off channels e.g.
  444.         the 7 channel TFMX-player. See the @{"Module type section" LINK modtypes}.@{ub}
  445. @ENDNODE
  446. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  447. @Node Loop
  448. @TITLE "Loop Active Module"
  449.   @{u}@{b}Module Loop:@{ub}@{uu}
  450.   This gadget can toggle between positions:
  451.   - No  looping,  which  will automatically skip to the next module, when a
  452.     module is finished.
  453.   - Looping,  which  will make the actual module start over again when it's
  454.     finished.
  455.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  456.   @{b}NOTE: This  function  is  only  supported  by  some  moduletypes. See the
  457.         @{"Moduletype section" LINK modtypes} for info. @{ub}
  458. @ENDNODE
  459. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  460. @Node Shuffle
  461. @TITLE "Shuffle Modulelist"
  462.   @{u}@{b}Modulelist Shuffler:@{ub}@{uu}
  463.   Pressing this gadget will shuffle all the modules in the list, making the
  464.   actual module the first. If no modules are played the first module in the
  465.   shuffled list will be loaded and played.
  466.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  467.   Of  course  this  function  only have a meaning when you have more than 2
  468.   modules in the list.
  469. @ENDNODE
  470. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  471. @Node Icn
  472. @TITLE "Iconify AccessiblePlayer"
  473.   @{u}@{b}Iconifying AccessiblePlayer:@{ub}@{uu} (Shortkey i)
  474.   This will close all the open windows belonging to the APlayer, and pop up
  475.   an  @{"APP-ICON" LINK App-icon}. If you want to open the Player again you just double-click
  476.   the   app-icon.  Or  you  can  use  the  popup-hotkey  specified  in  the
  477.   @{"configuration-window" LINK cfg}.
  478. @ENDNODE
  479. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  480. @Node App-icon
  481. @TITLE "App-Icon"
  482.   @{u}@{b}AccessiblePlayer App-icon:@{ub}@{uu}
  483.   When the APlayer is iconified you can drop module-icons on  the app-icon.
  484.   This is done by opening the drawer in which you are keeping your modules,
  485.   select one (or more, using shift), then move the pointer over the APlayer
  486.   app-icon  and  release the mousebutton. The modules will automatically be
  487.   appended to your actual modulelist, and if it's empty,  the  player  will
  488.   play the first of the dropped modules.
  489. @ENDNODE
  490. ---------------------------------------------------------------------------
  491. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  492. ---------------------------------------------------------------------------
  493. @Node ML
  494. @TITLE "Module list Editor"
  495.   @{u}@{b}Module list Editor:@{uu}@{ub} (Shortkey m)
  496.   This editor is used to create/change/load and save @{"modulelists" LINK modlist}.
  497.   @{b}Add:@{ub}    Opens  a  filerequester from which you can choose the modules you
  498.           want to add to the module list. The selected modules will  either
  499.           be added in the end of the list or, if you have selected a module
  500.           in the modulelist, just before that.
  501.   @{b}Del:@{ub}    Deletes the selected module from the list.
  502.           Pressing shift together with  the  del  button  will  delete  all
  503.           double instances of a module/file in the list.
  504.   @{b}Exg:@{ub}    Select  a  module,  press  exchange and pick a module to exchange
  505.           with the first.
  506.   @{b}Clear:@{ub}  Clears the module list completely.
  507.   @{b}Sort:@{ub}   Sorts the module list alphabetically.
  508.   @{b}Load:@{ub}   Opens  a  filerequester  which  lets  you open a new module list,
  509.           deleting the current one.
  510.   @{b}Append:@{ub} Exactly  the  same as above, but this will append the chosen list
  511.           at the end of the list, or just before the selected module.
  512.   @{b}Save:@{ub}   Opens  a  filerequester  which  lets  you save the current module
  513.           list, with an ".APML"- extension.
  514.   @{b}Arrow up/down:@{ub} These will move the marked module to  either  the position
  515.                  above or below.
  516.                  Pressing @{b}shift@{ub} in  conjunction  with the gadget, will move
  517.                  the selected module to the top or the bottom of the list.
  518.   The number of modules in the list can always be seen in the right side of
  519.   the window titlebar.
  520.   To move around in the list you can use the @{"keyboard" LINK listview}.
  521.   To highlight the module being played press control+return.
  522.   @{b}NOTE:@{ub} A  nice  feature  is  that if you doubleclick an item in the module
  523.         list, in the module list editor, the module will  be  loaded.  This
  524.         can give you a better view of how the list looks.
  525. @ENDNODE
  526. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  527. @NODE modlist
  528. @TITLE "Module list"
  529.   @{u}@{b}Module list:@{uu}@{ub}
  530.   The module list is the name for the modules displayed in the
  531.   @{"main window module list" LINK mainlistview}.
  532. @ENDNODE
  533. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  534. @Node Prev
  535. @TITLE "Previous module"
  536.   @{u}@{b}Previous module:@{uu}@{ub}
  537.   Pressing this button will tell APlayer to  restart  the  current  module,
  538.   except  if  the  current module is still playing the first pattern
  539. , then
  540.   APlayer will skip to the previous module in the list.
  541.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  542. @{b}NOTE: This function is only supported by some moduletypes.
  543.          See the @{"Moduletype section" LINK modtypes} for info. @{ub}
  544. @ENDNODE
  545. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  546. @Node Rew
  547. @TITLE "Rewind"
  548.   @{u}@{b}Rewind:@{uu}@{ub}
  549.   This will skip to the previous pattern in  the  current  module.  If  you
  550.   press rewind when the first pattern is playing, it will just restart.
  551.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  552.   @{b}NOTE: This function is only supported by some moduletypes.
  553.         See the @{"Moduletype section" LINK modtypes} for info. @{ub}
  554. @ENDNODE
  555. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  556. @Node Play
  557.   @{u}@{b}Play:@{uu}@{ub}
  558.   This opens a filerequester which lets you add one or more modules to  the
  559.   current  list  of  modules.  This will only disable the pause mode if you
  560.   have the @{"Jump To Loaded Module" LINK Jumtoaddedmodulepload} gadget in the configuration checked.
  561.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  562. @ENDNODE
  563. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  564. @Node FF
  565. @TITLE "Fast Forward"
  566.   @{u}@{b}Fast Forward:@{uu}@{ub}
  567.   Use this to skip to the  next pattern.  If you reach the end it will load
  568.   and play the next module.
  569.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  570.   @{b}NOTE: This function is only supported by some moduletypes.
  571.         See the @{"Moduletype section" LINK modtypes} for info. @{ub}
  572. @ENDNODE
  573. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  574. @Node Next
  575. @TITLE "Next module"
  576.   @{u}@{b}Next Module:@{uu}@{ub}
  577.   Pressing  this will tell APlayer to  skip to the next module in the list.
  578.   If  you  are  in  @{"pause" LINK pause} mode  APlayer will  unpause and skip to the next
  579.   module.
  580.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  581. @ENDNODE
  582. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  583. @Node Eject
  584. @TITLE "Eject module"
  585.   @{u}@{b}Eject:@{uu}@{ub}
  586.   Pressing this once will stop the current  module  and  free  the  memory.
  587.   Pressing it again clears the module list.
  588.   If you hold down the shift key while  pressing  the  eject  button,  will
  589.   eject all other modules than the one currently playing.
  590.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  591. @ENDNODE
  592. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  593. @Node Pause
  594. @TITLE "Pause module"
  595.   @{u}@{b}Pause:@{uu}@{ub}
  596.   This will simply pause the module playing right  now.  And  play  if  you
  597.   press it again.
  598.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  599. @ENDNODE
  600. -------------------------------------------------------------------------------
  601. @NODE keyboard
  602. @TITLE "Keyboard control keys"
  603.   @{b}These keys can be used in all windows when they are activated:@{ub}
  604.   --------------------------------------------------------------
  605.   @{b}Space              @{ub}: Can be used to  toggle  the  state  of  the
  606.                        audio  filter. However, if you have checked
  607.                        the  @{"Force Filter Off" LINK cfgoptions}   gadget   in   the
  608.                        configuration window, space will not affect
  609.                        anything.
  610.   @{b}TAB                @{ub}: Cycles through the APlayer windows.
  611.   @{b}Escape             @{ub}: Use this to close the  active  window.  All
  612.                        APlayer  windows  can be closed, except for
  613.                        the main window. If you press escape in the
  614.                        main window,  one of the other windows will
  615.                        close for each keypress.
  616.   @{b}These keys can only be used when the main window is activated:@{ub}
  617.   --------------------------------------------------------------
  618.   @{b}`  Back apostrophe @{ub}: Jump to random module and play it
  619.   @{b}~  Tilt            @{ub}: Shuffle
  620.   @{b}Del                @{ub}: Eject
  621.   @{b}Shift Return       @{ub}: Reset volume
  622.   @{b}Alt Return         @{ub}: Reset Speed
  623.   @{b}Arrow up           @{ub}: Like pressing the play button
  624.   @{b}Arrow down         @{ub}: Pause
  625.   @{b}Arrow left         @{ub}: Rewind
  626.   @{b}Arrow right        @{ub}: Forward
  627.   @{b}Shift Arrow left   @{ub}: Loads next module
  628.   @{b}Shift Arrow right  @{ub}: Loads previous module
  629.   @{b}Alt Arrow up       @{ub}: Increase speed
  630.   @{b}Alt Arrow down     @{ub}: Decrease speed
  631.   @{b}Alt Arrow left     @{ub}: Increase volume
  632.   @{b}Alt Arrow right    @{ub}: Decrease volume
  633.   @{b}[ or (             @{ub}: Toggle channel 1    \\
  634.                                             |
  635.   @{b}] or )             @{ub}: Toggle channel 2     |
  636.                                              
  637.  Top row on numpad
  638.   @{b}/                  @{ub}: Toggle channel 3     |
  639.                                             |
  640.   @{b}*                  @{ub}: Toggle channel 4    /
  641.   @{b}Backspace          @{ub}: Module loop on/off
  642.   @{b}<                  @{ub}: Cycle the maincycle gadget backwards
  643.   @{b}>                  @{ub}: Cycle the maincycle gadget forwards
  644.   For  control  keys  in  the special  windows,  see the  sections  on  the
  645.   different windows.
  646. @ENDNODE
  647. --------------------------------------------------------------------------------
  648. @NODE Tooltypes
  649. @TITLE "Tooltypes and CLI arguments.."
  650.   @{u}@{b}Tooltypes and CLI arguments:@{uu}@{ub}
  651.   (Lines in @{i}italic@{ui} explains what will  happen  when APlayer is started with
  652.   the argument/tooltype and APlayer is running already.
  653.   @{b}CX_POPUP (POP):@{ub} Defines if you want the APlayer to  open  its  window  at
  654.   startup, or start in hidden mode.
  655.   Keywords are @{b}YES@{ub} (default) or @{b}NO@{ub}.
  656.   @{b}CX_POPKEY (KEY):@{ub} The hotkey for APlayer. All valid commodity hotkeys will
  657.   work here. Default is "ctrl alt a".
  658.   @{b}CX_PRIORITY (PRI):@{ub} The APlayer task priority. Default is 0.
  659.   @{b}MODULE:@{ub} This argument is CLI ONLY! Just type the name (with path) of  the
  660.   module(s) and it will be placed in the modulelist. APlayer will not start
  661.   to play the first module, unless you also use the JUMP argument!
  662.   @{i}The modules will be added to the list.@{ui}
  663.   @{b}MODULELIST (ML):@{ub} The name of a modulelist file you want APlayer  to  use.
  664.   For instance S:example.APML. The modules in the modulelist will be placed
  665.   before any modules specified on the Command line.
  666.   @{i}The modules in the modulelist will be added to the list.@{ui}
  667.   @{b}CONFIGFILE (CFG):@{ub} Specifies the config file you want to use.  Default  is
  668.   ENV:APlayer/APlayer.prefs
  669.   @{b}PUBSCREEN (PS):@{ub} The  public  screen  on  which  you want APlayer to open.
  670.   Remember that  the  name is case SenSitiVe. Default is the default public
  671.   screen, e.g. Workbench.
  672.   @{i}APlayer  will  close all  the APlayer  windows  and  reopen  them  on the
  673.   specified public screen.@{ui}
  674.   @{b}LOOP:@{ub} Specifies the state of the loop gadget in the main window  (ON/OFF)
  675.   or toggles the state (as set in your configuration) (TOGGLE).
  676.   @{i}Same effect.@{ui}
  677.   @{b}INFOOPEN (IO):@{ub} This will force the info window to open at start.
  678.   @{i}Same effect.@{ui}
  679.   @{b}MODULELISTOPEN (MO):@{ub} If  you  want  the  module  list  window to  open at
  680.   startup, use this argument.
  681.   @{i}Same effect.@{ui}
  682.   @{b}FSSOPEN (FO):@{ub} Use this argument if you want the FSS window to  be  opened
  683.   at startup.
  684.   @{i}Same effect.@{ui}
  685.   @{b}SHUFFLE (SH):@{ub} If you use this argument,  all the modules  (or the modules
  686.   in the specified modulelist) will be shuffled. Just like if you press the
  687.   shuffle gadget in the main window.
  688.   @{i}This will  shuffle  all modules in the  modulelist,  including  any  just
  689.   added modules.@{ui}
  690.   @{b}PATH (P):@{ub} This option takes one argument, which is a path.  The path will
  691.   be scanned  for modules, just  like the @{"Start Scan Path" LINK cfgpaths} option. This can
  692.   be used in conjunction with the UNIQUE argument to add files  from a dir,
  693.   which is constantly updated.
  694.   @{b}UNIQUE (U):@{ub} This will avoid any modules to be represented more than  once
  695.   in  the modulelist. This works both with modules, the "Path" argument and
  696.   lha files.
  697.   @{b}NOTE:@{ub} If you specify any modules, a modulelist, or use the PATH argument,
  698.   your @{"scandir" LINK cfgpaths} will be ignored.
  699.   These parameters/tooltypes  can @{b}ONLY@{ub}  be  used  when  APlayer  is already
  700.   running:
  701.   @{b}JUMP (J):@{ub} This will  automatically jump to the  first module  just added,
  702.   independent of your @{"config setting" LINK jumptoaddedmodule}.
  703.   @{b}NOTE@{ub} : If you add modules via the CLI,  APlayer  will  not  automatically
  704.   play them @{b}unless@{ub} you use the JUMP argument.
  705.   @{b}QUIT (Q):@{ub} This  will quit the  player, WITHOUT executing the  arexx macro
  706.   defined in your @{"settings" LINK cfgarexx}.
  707. @ENDNODE
  708. -------------------------------------------------------------------------------
  709. @NODE Thanks
  710. @TITLE "The people and organizations we wish to thank"
  711.   @{u}@{b}Thanks to:@{uu}@{ub}
  712.   @{i}Nico Fran
  713. ois@{ui} for the fabulous Reqtools library and the powerpacker
  714.   library. + Magnus Holmgren for continuing the development of reqtools.
  715.   @{i}Urban Dominik Mueller@{ui} & @{i}Bryan Ford@{ui} for the great Xpk master library.
  716.   @{i}Jarno Paananen@{ui} for  the source to  his great PS3M, which  made us able to
  717.   support S3M, Fasttracker][ :) and many other formats ...
  718.   @{i}Martin Blom@{ui} for the fabolous AHI ..
  719.   @{i}Hans Henrik Happe@{ui} for the cool bar scope agent!
  720.   @{i}Anders Torin@{ui} for his author ARexx script ..
  721.   @{i}Teijo Kinnunen@{ui} for the great OctaMED Sound Studio + help!
  722.   @{i}John Hendrikx@{ui} for the SQSH library
  723.   @{i}Jorma Oksanen@{ui} for the SMPL library
  724.   @{i}Robin Schaap@{ui} for the information on ImpulseTracker and a lot of test
  725.   modules
  726.   @{i}Bo Lincoln@{ui} for the real Quadracomposer player (including the cia and all
  727.   commands)
  728.   @{i}Deftronic@{ui} for Trash'm-One (We hate the enforcer hits!!)
  729.   @{i}Michael Sinz@{ui} for Enforcer
  730.   @{i}Commodore@{ui} for Mungwall and Segtracker
  731.   @{i}Marley/Infect@{ui} for a lot of different moduletypes.
  732.   @{i}Lance Norskog@{ui} for Sox
  733.   All the @{i}authors@{ui} of the different players
  734.   @{i}Peter Hjelt@{ui} for the Smartplay which has been a big inspiration source for
  735.   the Accessible Player design.
  736.   @{i}KiLLraVeN/MYSTiC@{ui} Thanks  to  you for  the  bugreports. Keep  them coming.
  737.   (NOT :^) And for the fabulous Arexx script concerning modulelists.
  738.   @{i}Kaikumaa Timo@{ui} for the SoundTracker15 module.
  739.   @{i}Amiga@{ui} for being the best computer EVER (I.... outside!)
  740.   And to @{i}Amiga Technologies/Escom@{ui} for showing a lot of interest in keeping
  741.   developing the Amiga (We are looking forward to the PPC :)
  742.   All our @{i}betatesters@{ui}
  743. @ENDNODE
  744. -------------------------------------------------------------------------------
  745. @NODE History
  746. @TITLE "The History of AccessiblePlayer"
  747.   @{u}@{b}History:@{uu}@{ub}
  748.   @{"1.00" LINK h100} Released 2-Sep-1994
  749.   @{"1.01" LINK h101} (Not released)
  750.   @{"1.02" LINK h102} (Not released)
  751.   @{"1.03" LINK h103} (Not released)
  752.   @{"1.04" LINK h104} (Not released)
  753.   @{"1.10" LINK h110} Released 27-Dec-1994
  754.   @{"1.20" LINK h120} Released 15-Mar-1995
  755.   @{"1.21" LINK h121} Released 21-Mar-1995
  756.   @{"1.30" LINK h130} Released 29-May-1995
  757.   @{"1.40" LINK h140} Released 7-July-1995
  758.   @{"2.00" LINK h200} Released 27-Dec-1995 
  759.   @{"2.10" LINK h210} Released 23-Mar-1996
  760.   @{"2.11" LINK h211} Released 5-July-1996
  761.   @{"2.2" LINK h22}   Released 17-November-1996
  762.   @{"2.21" LINK h221}  Released 27-December-1996 (At "The Party 96" - yeah!)
  763.   @{"2.22" LINK h222}   Released 9-June-1997  The final version :~(
  764. @ENDNODE
  765. -------------------------------------------------------------------------------
  766. @NODE h100
  767. @TITLE "The History for Version 1.00"
  768.   1.00 (Released 2-Sep-1994)
  769.   --------------------------
  770.   - First public release.
  771. @ENDNODE
  772. -------------------------------------------------------------------------------
  773. @NODE h101
  774. @TITLE "The History for Version 1.01"
  775.   1.01 (Not released)
  776.   -------------------
  777.   - Ups!!! Fixed a bug in the tune  selector.  You  could  only  select  10
  778.     tunes, even if there were more.
  779.   - Fixed a bug in the Protracker player. It made  a  noisy  sound  if  you
  780.     played an empty sample with the volume command.
  781.   - A little bug fixed in the double buffering loader. If  the  loader  has
  782.     loaded the next module into the memory and you then delete it from  the
  783.     list  before it will start, the player will play it anyway. Now it will
  784.     load the next module instead.
  785.   - If you press the 's' key in the main window,  the  sample  info  window
  786.     will always open, even if the gadget was ghosted. This is fixed now.
  787. @ENDNODE
  788. -------------------------------------------------------------------------------
  789. @NODE h102
  790. @TITLE "The History for Version 1.02"
  791.   1.02 (Not released)
  792.   -------------------
  793.   - The global APG_WaitDMA routine is  changed,  so  it  will  use  EClocks
  794.     instead of raster lines. This mean the global data APG_Hz is obsolete.
  795.   - When APlayer tries to open a file, and it couldn't locate it,  it  will
  796.     now show the filename it tries to open instead of a simple "Object  not
  797.     found" requester.
  798.   - A little bug in the configuration loader. It didn't show an error if it
  799.     couldn't open the file and it cleared all players instead of  only  the
  800.     extern.
  801.   - The module loader will now show an open error requester.
  802.   - The "Delete from list" is changed to "Remove from list".
  803.   - Started to make ARexx interface.
  804. @ENDNODE
  805. -------------------------------------------------------------------------------
  806. @NODE h103
  807. @TITLE "The History for Version 1.03"
  808.   1.03 (Not released)
  809.   -------------------
  810.   - Now APlayer only allocates the channels when a  module  is  in  memory.
  811.     This means, all players are changed a bit and the two global  functions
  812.     APG_AllocChannels and APG_FreeChannels are also changed a bit.
  813.   - Fixed a bug in the IFF-8SVX and RIFF-WAVE player config routine.
  814.   - Changed the SID player to use the playsid.library.
  815. @ENDNODE
  816. -------------------------------------------------------------------------------
  817. @NODE h104
  818. @TITLE "The History for Version 1.04"
  819.   1.04 (Not released)
  820.   -------------------
  821.   - Added the FTM, Whittaker and the TFMX 1.5 player.
  822.   - Changed the loader routine, so now it will cut any fileextension if  it
  823.     couldn't open the file first time. This improves the TFMX loader.
  824.   - A minor bug in the SoundMonitor replayer fixed.
  825.   - A new version of the TFMX 7-Voice player is added. Now you can play the
  826.     Turrican III main tune without a crash after 3 minutes.
  827.   - Also a new version of the TFMX-Professional player is inserted. It will
  828.     not use VBlank anymore.
  829.   - Fixed some small bugs here and there.
  830. @ENDNODE
  831. -------------------------------------------------------------------------------
  832. @NODE h110
  833. @TITLE "The History for Version 1.10"
  834.   1.10 (Released 27-Dec-1994) At the Party '94 in Denmark.
  835.   --------------------------------------------------------
  836.   - Changed all the windows to be auto adjusted.
  837.   - The sample info & the module list windows  are  now  intelligent.  That
  838.     means, they will auto resize to the number of items in the list.
  839.   - Added zoom gadget in the titlebar in the main window.
  840.   - Removed the window positions & sizes from the main preference file into
  841.     and new preference file called APlayer.win. See the docs for more info.
  842.   - Fixed a major bug in the free module routine.  Sometimes  it  closes  a
  843.     library that should not be closed, such as the gadtools.library.
  844.   - Fixed a bug in the QuadraComposer player. It crashed when  it  plays  a
  845.     sample that doesn't exists.
  846.   - Fixed another bug in  the QuadraComposer  player. It crashes the second
  847.     time a module was started.
  848.   - Now you can use the  cursor keys and the return key in the Sample Info,
  849.     Module Editor, FSS and Players window.
  850.   - Players config files are moved to a subdirectory.
  851.   - You  can now  use a lots  of keys to  control the main  window  gadgets
  852.     (hotkeys).
  853.   - Added the Hippel, Hippel-COSO and the PumaTracker player.
  854.   - Added the IFF-AIFF player, and I hate IEEE numbers :^(.
  855.   - Changed the RIFF-WAVE player, so it also support 16-bits samples.
  856.   - You  can  now delete modules from your FSS list now!!! It was like hell
  857.     to make a delete function in a binary tree.
  858.   - The title in the main window are now font sentitive :)
  859.   - The  about  window  are  made  to  a separate window, just like all the
  860.     others.  That  means  it  will  be  updated  every time a new module is
  861.     loaded.
  862.   - HolyNoise player changed to MajorTom player.
  863. @ENDNODE
  864. -------------------------------------------------------------------------------
  865. @NODE h120
  866. @TITLE "The History for Version 1.20"
  867.   1.20 (Released 15-Mar-1995)
  868.   ---------------------------
  869.   - Optimized  the keypad playing. Now will APlayer first start to play the
  870.     sampling and then update the sample window.
  871.   - You can now use the keypad to select a sample when you play a module.
  872.   - Fixed a little bug in all the double click routines.
  873.   - Fixed  a  bug  in the JamCracker player. If you played on the keyboard,
  874.     the sample sounded strange.
  875.   - Fixed a bug in the loader routine.
  876.   - Changed  the  about  window,  so  now  you  can  switch between the two
  877.     "windows".  It  will also  be  updated  every time a module changes CIA
  878.     tempo.
  879.   - Now  you  can  encrypt  your modules with xpk. APlayer will ask for the
  880.     password. It will also unpack recursively. That means you can pack more
  881.     than  one time. You can use this, if you want to pack your modules with
  882.     SQSH and then encrypt them.
  883.   - Fixed a bug in the players own  config. Didn't put  the window to front
  884.     if it was already open.
  885.   - Added  volume  and  channel control and removed an  enforcer hit in the
  886.     Fred player.
  887.   - Added channel  control and song-end to  the Music-Assembler  player and
  888.     fixed  a bug  in the  player (not my fault!), so  now it also  works on
  889.     an A4000.
  890.   - The  Hippel player  is totally rewritten. Still some problems with some
  891.     tunes.
  892.   - Added a lot of new global functions and a few tags.
  893.   - Added the IFF-SMUS player.
  894.   - Added  some  new  CLI  and tooltype  arguments + changed some of them a
  895.     little bit. Now you can start APlayer again with new arguments.
  896.   - Fixed a little bug in the channel on/off keyboard routine.
  897.   - Now you can press return in the about window to close it.
  898.   - Added the Action Amics, In Stereo!, SidMon 1.0 and SidMon 2.0 players.
  899.   - I forgot  to set  the IntuiTicks  IDCMP flag  in all the  windows where
  900.     there was a listview gadget. This is  fixed now, so there should be a
  901.     repeat on the arrows.
  902.   - Added  the  Sonic  Arranger, Sound Control, SoundFX 1.3 and SoundFX 2.0
  903.     player.
  904.   - Fixed some small bugs here and there.
  905.   - Added the TME, Tronic Tracker and the VectorDean player.
  906.   - A  big bug  fixed (when APlayer tries to load the next module in hidden
  907.     mode).
  908.   - Some  small  bugs in  the Protracker player (Thanks to KiLLraVeN/MYSTiC
  909.     for telling us).
  910.   - Changed  all the  listviews. Now  I have  implemented  my own  listview
  911.     routines, and  that means  that the look is the  same on both KS3.0 and
  912.     KS2.0!!!
  913.   - Now the FSS will find out if you have moved some  modules next time you
  914.     hear them.
  915.   - Added Up/Down arrows in the module list editor.
  916.   - Added new Med/OctaMed players. Now supports MMD0/MMD1/MMD2 files.
  917.   - Added multiplay in the sample info window (press "DEL")
  918.   - New intelligent author finding system implemented.
  919. @ENDNODE
  920. ---------------------------------------------------------------------------
  921. @NODE h121
  922. @TITLE "The History for Version 1.21"
  923.   1.21 (Released 21-Mar-1995)
  924.   ---------------------------
  925.   - Due  to  a BIG bug  in version 1.20, which  made APlayer  unuseable  on
  926.     machines below  OS3.0, we  have released this  version, which have been
  927.     succesfully tested on an A600 (OS2.0).
  928.   - The author finding system have been improved on some points.
  929.   - The  name of  the actual module  is displayed in  the titlebar when the
  930.     window gets zipped.
  931.   - A few bugs have been fixed in the SID-, and the MusicAssembler-players.
  932.   - The default  hotkeys in the config  have been modified  a bit, we found
  933.     out  that  "control" couldn't  be  abbreviated  as "ctrl". But  all the
  934.     hotkeys works as always.
  935. @ENDNODE
  936. -------------------------------------------------------------------------------
  937. @NODE h130
  938. @TITLE "The History for Version 1.30"
  939.   1.30 (Released 29-May-1995)
  940.   ---------------------------
  941.   - Added menu in the ARexx configuration window.
  942.   - Changed the player config window design and added menus.
  943.   - Small minor bugs/fixes.
  944.   - Intern ProTracker to ProTracker/NoiseTracker/SoundTracker 15/31
  945.   - New Player Configuration file format (NOT BACKWARDS COMPATIBLE).
  946.   - Made the Paula noteplayer
  947.   - Added 2 new ARexx commands: GetNotePlayer & GetChannels.
  948.   - Renamed the Arexx command "GetType" to "GetPlayer"
  949.   - Added the NotePlayer bit in the "GetInfo" ARexx commando.
  950.   - Changed the Sample Info window.
  951.   - Added the Stereo-32Voices noteplayer.
  952.   - Added the FastTracker, TakeTracker and MultiTracker player.
  953.   - Added  the   FastMem-4Voices,   Mono-32Voices   and   Surround-32Voices
  954.     noteplayers.
  955.   - Optimized the APG_CalcVolume function.
  956.   - Added the RealSurround-32Voices and 14Bit-32Voices noteplayer.
  957.   - Added the ScreamTracker 3.0 and FastTracker 2.0 player.
  958.   - Now  can  you  change  the  tempo  on all players which uses the intern
  959.     interrupt.
  960.   - When you close the main config window, you will not automatic close the
  961.     player and arexx window anymore.
  962.   - Added key file system.
  963.   - Fixed a little bug in the RIFF-WAVE player.
  964.   - The  RexxMsg  field  in  the  main cycle gadget is removed if ARexx not
  965.     turned on.
  966.   - Added  to  the  module  list window titlebar the number of items in the
  967.     module list.
  968.   - Added the DeliCustom player.
  969.   - Fixed  bug  that prevented  resizing of ModuleList-window  after adding
  970.     modules from CLI.
  971.   - Fixed  bug that  tried to load  LhA-icons dropped  on the icon  or main
  972.     window as normal modules.
  973. @ENDNODE
  974. -------------------------------------------------------------------------------
  975. @NODE h140
  976. @TITLE "The History for Version 1.40"
  977.   1.40 (Released 7-July-1995) At the South Sealand Party '95
  978.   ----------------------------------------------------------
  979.   - Oktalyzer uses a NotePlayer now and added a lot of extra features.
  980.   - Fixed a mixing bug in the Mono-NotePlayer.  It  mixes the channels in a
  981.     wrong order.
  982.   - If  you  play  a module and you have the player config window open, you
  983.     can  see  which  player  is  active. If you then choose one of the menu
  984.     items  that  load  a  new  config  file,  the active player will not be
  985.     highlighted again if it is in the list. This is fixed now.
  986.   - Fixed  a  bug  in  the  Pro/NoiseTracker player. It didn't mask out the
  987.     finetune  value,  and  therefore  with  some  modules  if  sounds  very
  988.     abstract.
  989.   - QuadraComposer and JamCracker uses a NotePlayer now.
  990.   - If you try to play some AM samples and the player uses a NotePlayer, it
  991.     try to play it. This is fixed now.
  992.   - FutureComposer 1.0-1.3 and FutureComposer 1.4 uses a NotePlayer now.
  993.   - Now  you  can use the KEYPATH enviroment variable to the path where you
  994.     have stored your key-file.
  995.   - The playing module is now highlighted both in the main window and i the
  996.     modulelist.
  997.   - Added the Art Of Noise player.
  998.   - Fixed a pausing bug in the FTM player (Thanks Hans Malte Kern :=)
  999.   - NEW! Agent sample save interface created.
  1000.   - Fixed a serius bug i Paula-noteplayeren. Sometimes it made some strange
  1001.     sounds.
  1002. @ENDNODE
  1003. -------------------------------------------------------------------------------
  1004. @NODE h200
  1005. @TITLE "The History for Version 2.00"
  1006.   2.00 (Released 27-Dec-1995)
  1007.   ---------------------------
  1008.   - Rewritten the Fibonacci encoding for IFF-8SVX, now it works 100%
  1009.   - Added a progress bar when you convert or save samples.
  1010.   - Added  some players: Activision  Pro, Delta  Music  2.0,  SoundFactory,
  1011.     MarkII, TimFolin, Voodoo Supreme Synthesizer, Mark Cooksey, J.C.Brooke
  1012.     and Sound Monitor 2.2.
  1013.   - The IFF-8SVX, IFF-AIFF and RIFF-WAVE players now uses Noteplayers.
  1014.   - Added "Play Once" to the sample players.
  1015.   - Added IFF-AIFF, RIFF-WAVE and RAW sample converters.
  1016.   - MED now uses Noteplayers. Do not use the Fastmem  noteplayer  with  MED
  1017.     with synth sounds, they will be skipped.
  1018.   - No matter which window you have activated, you can choose which subsong
  1019.     to play (with 0-9 +/-) Previously  this was not possible  in the config
  1020.     and show windows.
  1021.   - The IFF-8SVX sample saver now also saves the author name.
  1022.   - Added the Scope Interface (Graphical scopes to everyone). This includes
  1023.     the RGB box, Spinning Squares and the Bar-Scope.
  1024.   - We will NOT guarantee anything if you use FAKE key files for APlayer.
  1025.   - The (?/?) will show the module position when you zip the main window.
  1026.   - The CX_PRI argument now works correctly.
  1027.   - If you  add modules  via the CLI, APlayer  will not  automatically play
  1028.     them unless you use the JUMP argument.
  1029.   - Pressing <shift>+Eject will delete all but the playing module.
  1030.   - Pressing <shift>+Del button  in the Modulelist  window will  delete all
  1031.     double instances of module.
  1032.   - Pressing <ctrl> + <return> in  the Modulelist  window will  select  the
  1033.     playing module.
  1034.   - Updated the Noteplayers to use Jarno paananens S3M version 3.12.
  1035.   - Added the new configuration interface.
  1036.   - Fixed a bug which could cause APlayer to crash under OS2.0
  1037.   - Added the why function in error requesters.
  1038.   - Added Online Help (Place pointer and press <HELP>)
  1039.   - Warning! If  you use  the  XFH package  on your harddisk, do not  do an
  1040.     "Avail flush" command. Due  to unknown reasons this will  cause several
  1041.     programs, including APlayer, to crash.
  1042.   - + the usual amount of bug fixes :)
  1043. @ENDNODE
  1044. -------------------------------------------------------------------------------
  1045. @NODE h210
  1046. @TITLE "The History for Version 2.10"
  1047.   2.10 (Released 23-Mar-1996)
  1048.   ---------------------------
  1049.   @{i}@{b}Added Features:@{ui}@{ub}
  1050.   - Created the FreqAnalyzer Scope.
  1051.   - Added the  LoopRetrig  bit  for  noteplayers,  which  MED/OctaMed  uses
  1052.     instead of always trigging the samples on loop. There was some troubles
  1053.     with some module types, e.g. AON.
  1054.   - Implemented Delta 1.0, Hippel 7-voices,  InStereo  2.0  and  SynTracker
  1055.     which uses noteplayers.
  1056.   - Made 3 new ARexx commands: GetScriptPath, GetScreen and SetScreen.
  1057.     (Hi Killraven :)
  1058.   @{i}@{b}Changes:@{ui}@{ub}
  1059.   - Support for the Powerpacker.library is gone. It caused several computer
  1060.     crashes, so if you want powerpacker support use the xpkmaster library.
  1061.     This will unpack all your powerpacked modules flawlessly.
  1062.   - Now all the TFMX players are able to play single-file modules.
  1063.     TFMX Pro and 7-voices is joined together and uses noteplayers (yes!)
  1064.   - Changed the Scope Interface,  so  that  it  could  get  the  number  of
  1065.     channels used by the playing module.
  1066.   - The FasttrackerII player is  updated  to  version  3.11.  As  mentioned
  1067.     earlier we don't use version 3.12 of the player because  it's  terrible
  1068.     buggy. The version 3.10 had some problems with some of the modules from
  1069.     the Party V, but they can now be played flawlessly (we think :).
  1070.   - The resize bar is now moved to the bottom of the window in  the  MLED-,
  1071.     and sample-window. (Hi Marcus :)
  1072.   - Improved the startup routine and changed APlayer to use the AutoRequest
  1073.     function if the error  "Can't  open  library  ..."  occured,instead  of
  1074.     opening it's own new window.
  1075.   - The fastmem noteplayer-config is gone, there is no need to  change  the
  1076.     buffer size anymore.
  1077.   - Some recognition problems with certain  Hippel-COSO  modules  are  gone
  1078.     now, and player now supports sample info and uses noteplayer.
  1079.   - MusicAssembler, SidMon 2.0, SoundFx1.3, SoundFx2.0, VectorDean
  1080.     now uses noteplayers
  1081.   - The cut-prefix string is expanded to 256 characters  (hopefully  no-one
  1082.     will have any problems now :)
  1083.   - Now the windows will sleep while you're ejecting the modulelist.
  1084.   - Info about the actual (note)player is immediatly shown  when  you  open
  1085.     the (note)player config window.
  1086.   @{b}@{i}Bugfixes:@{ui}@{ub}
  1087.   - Sometimes Future Composer did set the volume too high.
  1088.   - A deadlock which could appear with a required noteplayer not being able
  1089.     to get enough memory is gone now.
  1090.   - If you have set the loop gadget when you hear the last module  in  your
  1091.     list + you have "fade on end" set to on, then APlayer would fade at the
  1092.     end of the module, which it shouldn't, because of the loop.
  1093.   - A lot of possible deadlock situations and neverending loops  caused  by
  1094.     the FSS agent has been removed.
  1095.   - The ARexx commands to set the main-cycle didn't work anymore after  the
  1096.     config window changed.
  1097.   - If there was a load error  from  a  player  load-routine  and  you  had
  1098.     doublebuffering on, APlayer closed the player library one time to much.
  1099.   - Argggggghhhhhhhhh! All the protracker/noisetracker a.s.o. players has a
  1100.     MAJOR bug. This bug is to be found in ALL other player programs (as far
  1101.     as we know). There is a calculation error when finding the next pattern
  1102.     line to play. 2 words were added but words weren't enough as  it  could
  1103.     result  in  a wrap-around when adding. This has been changed so it uses
  1104.     long-words now. We are the first to fix this problem.
  1105.   - The "Used patterns" field in the about  window  was  miscalculated  for
  1106.     protracker modules. i.e. the number was 1 pattern to small.
  1107.   - If, in the Module List Editor,  you  choose  another  module  than  the
  1108.     playing one, and  presses  ctrl-return  the  playing  module  will  get
  1109.     selected.  If you then tries to delete the module, the module which was
  1110.     previously selected will be deleted instead.
  1111.   - Ffw/rewind buttons now (again) works as they should with S3M modules.
  1112.   - If APlayer  couldn't  allocate  a  CIA  timer,  APlayer  would  give  a
  1113.     recoverable alert when selecting cancel in the  requester.  On  top  of
  1114.     this the "Retry" and "why" gadgets were swapped.
  1115.   - If an error occurs from the unpacker library, the first letter  in  the
  1116.     error message would disappear.
  1117.   - The following places will now function properly with propertional fonts
  1118.  About window
  1119.  Main cycle
  1120.  Sample Info Window
  1121.   - If you disabled the FSS agent  while  it  was  loading  its  data,  the
  1122.     APlayer windows weren't sleeping.
  1123.   - Eject Module At End of list didn't work with only  one  module  in  the
  1124.     list -now it does!
  1125.   - If you played a sample and used "Eject at end of list", then  both  the
  1126.     sample AND the modulelist would be freed, but the display wouldn't  get
  1127.     updated.
  1128.   - Rnd One/All in the FSS agent works again.
  1129.   - If you optimized your fss list, the number  of  elements  in  the  list
  1130.     wasn't updated.
  1131.   - Only the first 22 chars of the filename was shown in the fss list.
  1132.   - The Iconify error (when it produced enforver hits) has been removed.
  1133.   - The Pro/Noisetracker test  routine  is  improved.  All  speed  problems
  1134.     should hopefully be history now.
  1135.   - A minor problem with speed commands in  the  QuadraComposer  player  is
  1136.     removed.
  1137.   - If you exit APlayer with a scope window open, while using Mungwall, the
  1138.     scope task crashed.
  1139. @ENDNODE
  1140. -------------------------------------------------------------------------------
  1141. @NODE h211
  1142. @TITLE "The History for Version 2.11"
  1143.   2.11 (Released 5-Jul-1996) At the South Sealand Party '96
  1144.   ---------------------------------------------------------
  1145.   @{i}@{b}Attention:@{ui}@{ub}
  1146.   The next version of APlayer is probably not to appear before this years
  1147.   Christmas-time, because of some major plans:
  1148.  The whole APlayer code will be rewritten/converted to C. This will
  1149.     hopefully make a portation to other computer platforms/CPU's easier.
  1150.     In the future we will hopefully get Power Amigas, or maybe the Bebox
  1151.     will gain market (it looks like a possible cool platform :)
  1152.  Because a conversion/rewriting is a @{i}very@{ui} hard and lengthy
  1153.     process, the next APlayer will as mentioned probably not appear
  1154.     before Christmas 96.
  1155.  While reprogramming the whole stuff, a new and improved graphical
  1156.     interface will be implemented (Not MUI), including font sensitivity,
  1157.     4/8 colour interface (probably MagicWB-style) and even more along the
  1158.     road.
  1159.   We hope that you, the user of APlayer, can understand and accept our
  1160.   decisions on the way APlayer is going to develop in the future.
  1161.   Because the rewriting demands pretty much from the one and only
  1162.   programmer, Thomas Neumann, he can not also use any time for developing
  1163.   new players, noteplayers or fix bugs.
  1164.   @{b}Therefore we ask you to step forward and be a volunteer!@{ub} Can you
  1165.   program Amiga assembler, do you have some (or much) knowlegde of the
  1166.   amiga audio system ? and do you want to become part of the APlayer
  1167.   project ?
  1168.   Then here is your chance .. Write a letter (E-mail) to one of the
  1169.   addresses you find @{"here" LINK contact}. We will ofcourse supply you
  1170.   with any information/source you need to be a developer.
  1171.   We are looking forward to some hopefully serious contacts :)
  1172.   Now have fun with APlayer 2.11 ..
  1173.   @{i}@{b}Added Features:@{ui}@{ub}
  1174.   - Added the Worms multi sample saver module, which enables everyone to
  1175.     convert and use PC-Worms samplebanks with Worms for the Amiga - YEAH!
  1176.   - Added ping-pong support in the FastTracker II player.
  1177.   - Added the Digibooster player.
  1178.   - Added the THX Sound System player.
  1179.   @{i}@{b}Changes:@{ui}@{ub}
  1180.   - The test routine for Soundtracker 15 and 31 has been rewritten, it
  1181.     should work properly in any case now.
  1182.   - All sample players now uses a priority of 4 instead of 9. This should
  1183.     help most crashing problems.
  1184.   - The SID player now supports scopes.
  1185.   @{b}@{i}Bugfixes:@{ui}@{ub}
  1186.   - A problem depending on a combination between double buffering
  1187.     and restarting an already loaded module, causing a serious breakdown,
  1188.     has been fixed.
  1189.   - The scopes can now open even if the APlayer window isn't.
  1190.     They will just open on the default public screen.
  1191.   - Some fonts would cause the Multi sample saver listviews to be too high.
  1192.   - APlayer 2.1 saved the .win prefs file with a wrong version number in
  1193.     it. This caused it not to be loaded afterwards because the number was
  1194.     too high - ups! :)
  1195.   - A lot of bugs has been removed from the Fasttracker II (XM) and
  1196.     ScreamTracker3 (S3M) players. Hopefully no more random gurus occurs
  1197.     now. YES!
  1198.   - Fixed a lot of bugs in the multi sample saver.
  1199.   - Fixed a minor bug in the module author routine.
  1200.   @{b}@{i}Known Bugs:@{ui}@{ub}
  1201.   - With some Amigaguide library and datatype version, APlayer will crash on
  1202.     startup on some Amigas.
  1203. @ENDNODE
  1204. -------------------------------------------------------------------------------
  1205. @NODE h22
  1206. @TITLE "The History for Version 2.2"
  1207.   2.2 (Released 17-Nov-1996)
  1208.   --------------------------
  1209.   @{i}@{b}Added Features:@{ui}@{ub}
  1210.   - Added the AHI noteplayer - which is still in development
  1211.   - Added the OctaMED Sound Studio player - world premiere!!
  1212.     It is still under development - and lacks a few things, but
  1213.     it works - but does NOT use noteplayers.
  1214.   @{i}@{b}Changes:@{ui}@{ub}
  1215.   - Merged the Fast-, and Take-tracker players, so that the Fasttracker
  1216.     player now plays both formats.
  1217.   - Updated the THX player. It now supports number of samples, fastmem
  1218.     replay and both the 68000 + 68020.
  1219.   - Check out the new APlayer homepage
  1220.     http://www.cybercity.dk/users/ccc12396
  1221.   @{b}@{i}Bugfixes:@{ui}@{ub}
  1222.   - The first module in the ModuleList couldn't be started by pressing
  1223.     return in the MLED window.
  1224.   - If you dropped a module in the main window, it would Always be played,
  1225.     no matter what your preferences where set to.
  1226.   - Trying to load a no-modulelist-file as such would result in a guru.
  1227.   - The CLI argument PATH didn't update the title in the MLED window.
  1228.   - Trying to play the samples from a Digibooster module didn't work.
  1229.   - A few octaves were missing in the notetables in the Fastracker I
  1230.     player. This resulted in some strange notes from time to time. Try
  1231.     and listen to the module DOPE now - it sounds much better.
  1232.   - At last the bug that caused the MLED window to crash has been found -
  1233.     yuippie! It had something to do with the font used in the title bar,
  1234.     and the user having more than 99 modules in the list. That is only
  1235.     registred users should have experienced this bug.
  1236.   @{b}@{i}Known Bugs:@{ui}@{ub}
  1237.   - With some Amigaguide library and datatype version, APlayer will crash on
  1238.     startup on some Amigas.
  1239.   - The OctaMED Sound Studio player has some problems with the offset
  1240.     command. We have been in contact with Teijo to get a new version. As
  1241.     soon as the bug is fixed an updated version will be released
  1242.     separately.
  1243. @ENDNODE
  1244. -------------------------------------------------------------------------------
  1245. @NODE h221
  1246. @TITLE "The History for Version 2.21"
  1247.   2.21 (Released 27-Dec-1996)
  1248.   ---------------------------
  1249.   @{i}@{b}Added Features:@{ui}@{ub}
  1250.   - Musicline player implemented
  1251.   @{i}@{b}Changes:@{ui}@{ub}
  1252.   - The AHI-noteplayer is finished. Sampleplay via the sampleinfo window is
  1253.     now possible. Support for OctaMED and samples added.
  1254.   - OctaMED is now updated with the newest source direct from Teijo :)
  1255.   @{b}@{i}Bugfixes:@{ui}@{ub}
  1256.   - Tempo calculation in AHI is now more precise (with decimals).
  1257.   - Sometimes a crash occured when ejecting and while using AHI - fixed!
  1258.   - S3M didn't work correctly with AHI, it does now!
  1259.   - Finally removed the bug that could cause APlayer to crash when the main
  1260.     window was zipped - yes!
  1261.   - The FSS optimizer now works (sometimes it failed)
  1262.   - Playing samples in multi mode with Digibooster modules invited the Guru!
  1263.   - Med/OctaMED/Sample-players didn't support tempo with AHI - fixed!
  1264.   - Removed even more enforcerhits from the Digibooster player.
  1265.   @{b}@{i}Known Bugs:@{ui}@{ub}
  1266.   - With some Amigaguide library and datatype version, APlayer will crash on
  1267.     startup on some Amigas.
  1268. @ENDNODE
  1269. -------------------------------------------------------------------------------
  1270. @NODE h222
  1271. @TITLE "The History for Version 2.22"
  1272.   2.22 (Released 9-Jun-1997)
  1273.   --------------------------
  1274.   @{i}@{b}Added Features:@{ui}@{ub}
  1275.   - Added the ImpulseTracker player. Thanks Robin Schaap!
  1276.   - Added the Ben Daglish player.
  1277.   @{i}@{b}Changes:@{ui}@{ub}
  1278.   - Updated the THX player. It should now work on a 68000 CPU, but it can't
  1279.     be tested since we don't know anyone with such a processor :)
  1280.   - Digibooster modules are now played from fastmemory, but that sacrifices the
  1281.     ability to play the samples in the sample-info window.
  1282.   - AHI only plays signed samples now, therefore Multitracker samples are
  1283.     converted from unsigned to signed.
  1284.   - The S3M player has been updated to version 3.13, which includes :
  1285.     - speed effect fixed
  1286.     - tremor fx added
  1287.     - pattern delay fx added
  1288.     - pattern break fixed
  1289.     - pattern loop fixed
  1290.   - The XM player has also been updated to version 3.13, including :
  1291.     - pattern break fixed
  1292.     - pattern loop fixed
  1293.     - envelopes fixed
  1294.     - sample offset fx fixed
  1295.     - added instrnum sanity check (changed a bit)
  1296.     - speed effect fixed.
  1297.   @{b}@{i}Bugfixes:@{ui}@{ub}
  1298.   - Digibooster modules didn't go on to the next module at a F00 command.
  1299.   @{b}@{i}Known Bugs:@{ui}@{ub}
  1300.   - With some Amigaguide library and datatype version, APlayer will crash on
  1301.     startup on some Amigas.
  1302. @ENDNODE
  1303. -------------------------------------------------------------------------------
  1304. @NODE contact
  1305. @TITLE "Contact addresses"
  1306.   Send bugreports, new players including modules and suggestions to
  1307.   Coder:
  1308.   ------
  1309.   Thomas Neumann (Tax)
  1310.   Reb
  1311. park 3, 7., 710
  1312.   2650 Hvidovre
  1313.   Denmark
  1314.   E-Mail: tneumann@usa.net
  1315.   Designer, Alphatester & Guide writer:
  1316.   -------------------------------------
  1317.   Jakob Langgaard (Jail)
  1318.   Krebsen 101
  1319.   3650 
  1320. lstykke
  1321.   Denmark
  1322.   E-mail: jail@diku.dk (this will hopefully last a few years :)
  1323. @ENDNODE
  1324. --------------------------------------------------------------------------
  1325. @NODE ArexxMain
  1326. @TITLE "ARexx"
  1327.   @{b}@{u}ARexx with the APlayer:@{ub}@{uu}
  1328.   This section will describe all  the  commands  available  for  the  ARexx
  1329.   interface  in APlayer. If you don't know anything about ARexx, you should
  1330.   either skip this part, or try to find some documentation on the subject.
  1331.   To help you to get a better overview of the commands, we have split  into
  1332.   the following sections:
  1333.   @{" Channels   " LINK ARChannel} - Manipulate Channels
  1334.   @{" Eject      " LINK AREject} - Controls the Eject Function
  1335.   @{" Loop       " LINK ARLoop} - Change Loop
  1336.   @{" Main Cycle " LINK ARMaincycle} - Manipulate the Main Cycle
  1337.   @{" Modulelist " LINK ARModulelist} - Manipulate the Module list
  1338.   @{" Pause      " LINK ARPause} - Change the Pause state
  1339.   @{" Play       " LINK ARPlay} - What to Play
  1340.   @{" Requester  " LINK ARRequester} - Make ReqTools Requsters
  1341.   @{" Sample     " LINK ARSample} - Use the Sample Functions
  1342.   @{" Speed      " LINK ARSpeed} - Change/Get the Speed State
  1343.   @{" Tech Info  " LINK ARTechnical} - Get a lot of Technical Info
  1344.   @{" Various    " LINK ARVarious} - Miscellaneous
  1345.   @{" Volume     " LINK ARVolume} - Change/Get the Volume State
  1346.   @{" Wind       " LINK ARWind} - Forward/Rewind
  1347.   @{" Window     " LINK ARWindow} - Window Commands
  1348. @ENDNODE
  1349. ------------------------------------------------------------------------
  1350. @NODE ARChannel
  1351. @TITLE "Channels"
  1352.   @{b}@{u}Channels:@{ub}@{uu}
  1353.   @{b}Command:@{ub}
  1354.     ChannelOff @{i}channel@{ui}
  1355.   @{b}Description:@{ub}
  1356.     Turns off the channel "channel".
  1357.   @{b}Input:@{ub}
  1358.     channel - A channel number between 1 and 4.
  1359.   @{b}Result:@{ub}
  1360.     None.
  1361.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1362.   @{b}Command:@{ub}
  1363.     ChannelOn @{i}channel@{ui}
  1364.   @{b}Description:@{ub}
  1365.     Turns on the channel "channel".
  1366.   @{b}Input:@{ub}
  1367.     channel - A channel number between 1 and 4.
  1368.   @{b}Result:@{ub}
  1369.     None.
  1370.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1371.   @{b}Command:@{ub}
  1372.     state = GetChannel @{i}channel@{ui}
  1373.   @{b}Description:@{ub}
  1374.     Get the current state of the channel "channel".
  1375.   @{b}Input:@{ub}
  1376.     channel - A channel number between 1 and 4.
  1377.   @{b}Result:@{ub}
  1378.     state - This is a boolean where FALSE means off and TRUE means on.
  1379.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1380.   @{b}Command:@{ub}
  1381.     state = ToggleChannel @{i}channel@{ui}
  1382.   @{b}Description:@{ub}
  1383.     Toggles the state of the channel "channel".
  1384.   @{b}Input:@{ub}
  1385.     channel - A channel number between 1 and 4.
  1386.   @{b}Result:@{ub}
  1387.     state - This is a boolean where FALSE means off and TRUE means on.
  1388. @ENDNODE
  1389. ------------------------------------------------------------------------
  1390. @NODE AReject
  1391. @TITLE "Eject"
  1392.   @{b}Command:@{ub}
  1393.     ClearList
  1394.   @{b}Description:@{ub}
  1395.     This will eject the current playing module, and free the  rest  of  the
  1396.     list. Which is the same as if you've clicked the eject button 2 times.
  1397.   @{b}Input:@{ub}
  1398.     None
  1399.   @{b}Result:@{ub}
  1400.     None
  1401.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1402.   @{b}Command:@{ub}
  1403.     Eject
  1404.   @{b}Description:@{ub}
  1405.     This will either eject the currently playing module or eject the  whole
  1406.     list.  If a module is being played it will be ejected, and if no module
  1407.     is loaded played the list will be ejected.
  1408.   @{b}Input:@{ub}
  1409.     None
  1410.   @{b}Result:@{ub}
  1411.     None
  1412. @ENDNODE
  1413. ------------------------------------------------------------------------
  1414. @NODE ARLOOP
  1415. @TITLE "LOOP"
  1416.   @{b}Command:@{ub}
  1417.     state = GetLoop
  1418.   @{b}Description:@{ub}
  1419.     Get the current state of the loop gadget. The result is a boolean and 1
  1420.     means on and 0 means off.
  1421.   @{b}Input:@{ub}
  1422.     None
  1423.   @{b}Result:@{ub}
  1424.     state - This is a boolean where FALSE means off and TRUE means on.
  1425.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1426.   @{b}Command:@{ub}
  1427.     LoopOff
  1428.   @{b}Description:@{ub}
  1429.     Set the loop to off.
  1430.   @{b}Input:@{ub}
  1431.     None
  1432.   @{b}Result:@{ub}
  1433.     None
  1434.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1435.   @{b}Command:@{ub}
  1436.     LoopOn
  1437.   @{b}Description:@{ub}
  1438.     Turns the loop on.
  1439.   @{b}Input:@{ub}
  1440.     None
  1441.   @{b}Result:@{ub}
  1442.     None
  1443.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1444.   @{b}Command:@{ub}
  1445.     state = ToggleLoop
  1446.   @{b}Description:@{ub}
  1447.     Toggles the loop and return the new state.
  1448.   @{b}Input:@{ub}
  1449.     None
  1450.   @{b}Result:@{ub}
  1451.     state - This is a boolean where FALSE means off and TRUE means on.
  1452. @ENDNODE
  1453. ------------------------------------------------------------------------
  1454. @NODE ARMAINCYCLE
  1455. @TITLE "MainCycle"
  1456.   @{b}Command:@{ub}
  1457.     name = GetCycle
  1458.   @{b}Description:@{ub}
  1459.     Get the current position of the main cycle. It  will  return  a  string
  1460.     with the cycle name, like Author.
  1461.   @{b}Input:@{ub}
  1462.     None
  1463.   @{b}Result:@{ub}
  1464.     name - a string with the name of the cycleposition.
  1465.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1466.   @{b}Command:@{ub}
  1467.     RexxMsg @{i}string@{ui}
  1468.   @{b}Description:@{ub}
  1469.     Changes the contents of the REXXMSG in the main cycle.
  1470.   @{b}Input:@{ub}
  1471.     String - a normal text string.
  1472.   @{b}Result:@{ub}
  1473.     None
  1474.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1475.   @{b}Command:@{ub}
  1476.     error = SetCycle @{i}name@{ui}
  1477.   @{b}Description:@{ub}
  1478.     Set the main cycle to the "name", like SetCycle Author. It will  return
  1479.     an error if it couldn't find the name.
  1480.   @{b}Input:@{ub}
  1481.     name - a string with the name of the cycleposition.
  1482.   @{b}Result:@{ub}
  1483.     error - an error code which indicates if it could find the name in  the
  1484.             cycle. 0 means ok and 1 means error. Note that the result is in
  1485.             RC and not in RESULT.
  1486. @ENDNODE
  1487. ------------------------------------------------------------------------
  1488. @NODE ARMODULELIST
  1489. @TITLE "ModuleList"
  1490.   @{b}Command:@{ub}
  1491.     error = AddMod @{i}file@{ui}
  1492.   @{b}Description:@{ub}
  1493.     Adds the module with the name "file" to the module list.
  1494.   @{b}Input:@{ub}
  1495.     file - the name of the module you want to add.
  1496.   @{b}Result:@{ub}
  1497.     error - if it can't find the file. 0 means ok and 1 means  error.  Note
  1498.             that  the  result  is  in  that  the result is in RC and not in
  1499.             RESULT.
  1500.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1501.   @{b}Command:@{ub}
  1502.     AppendList @{i}num file@{ui}
  1503.   @{b}Description:@{ub}
  1504.     Adds a module list with the name "file" to the module  list.  "num"  is
  1505.     the number in the list you want to insert the new list at. -1 means the
  1506.     buttom of the list.
  1507.   @{b}Input:@{ub}
  1508.     num - the position where you want to insert.
  1509.     file - the modulelist to insert.
  1510.   @{b}Result:@{ub}
  1511.     error = this is an error code where 0 means ok and 1 means error.  Note
  1512.             that the result is in RC not in RESULT.
  1513.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1514.   @{b}Command:@{ub}
  1515.     error = DelMod @{i}num@{ui}
  1516.   @{b}Description:@{ub}
  1517.     Deletes the module "num" in the module list.
  1518.   @{b}Input:@{ub}
  1519.     num - the number of the module to be deleted from  the  list,  starting
  1520.           from 1.
  1521.   @{b}Result:@{ub}
  1522.     error = this is an error code where 0 means ok and 1 means error.  Note
  1523.             that the result is in RC not in RESULT.
  1524.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1525.   @{b}Command:@{ub}
  1526.     error = ExgMods @{i}num1 num2@{ui}
  1527.   @{b}Description:@{ub}
  1528.     Exchange the two modules "num1" and "num2" in the module list.
  1529.   @{b}Input:@{ub}
  1530.     num1 and num2 - the number of the modules  to be exchanged in the list,
  1531.                     starting with 1.
  1532.   @{b}Result:@{ub}
  1533.     error = this is an error code where 0 means ok and 1 means error.  Note
  1534.             that the result is in RC not in RESULT.
  1535.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1536.   @{b}Command:@{ub}
  1537.     max = GetMaxNames
  1538.   @{b}Description:@{ub}
  1539.     Returns the number of modules in the module list.
  1540.   @{b}Input:@{ub}
  1541.     None
  1542.   @{b}Result:@{ub}
  1543.     max - the number of modules in the list.
  1544.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1545.   @{b}Command:@{ub}
  1546.     name = GetModName @{i}num@{ui}
  1547.   @{b}Description:@{ub}
  1548.     Returns the name of the module with the number "num" with full path.
  1549.   @{b}Input:@{ub}
  1550.    num - the number of the module from which you want  the  name,  starting
  1551.          with 1.
  1552.   @{b}Result:@{ub}
  1553.     error = this is an error code where 0 means ok and 1 means error.  Note
  1554.             that the result is in RC not in RESULT.
  1555.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1556.   @{b}Command:@{ub}
  1557.     num = GetModNum @{i}name@{ui}
  1558.   @{b}Description:@{ub}
  1559.     This will return the number of the module named "name". If it  couldn't
  1560.     find the name, a zero will be returned.
  1561.   @{b}Input:@{ub}
  1562.     name - the file name (without path) of the module in the list.
  1563.   @{b}Result:@{ub}
  1564.     num - the number of the module in the  list.
  1565.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1566.    @{b}Command:@{ub}
  1567.      path = GetScriptPath
  1568.    @{b}Description:@{ub}
  1569.      Returns the APML path.
  1570.    @{b}Input:@{ub}
  1571.      None
  1572.    @{b}Result:@{ub}
  1573.      path - The APML path.
  1574.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1575.   @{b}Command:@{ub}
  1576.     LoadList @{i}file@{ui}
  1577.   @{b}Description:@{ub}
  1578.     Loads a new APML list with the filename "file".
  1579.   @{b}Input:@{ub}
  1580.     file - the name of the modulelist to be loaded.
  1581.   @{b}Result:@{ub}
  1582.     None
  1583.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1584.   @{b}Command:@{ub}
  1585.     error = SaveList @{i}file@{ui}
  1586.   @{b}Description:@{ub}
  1587.     Saves the current module list with the filename "file". If  the  module
  1588.     list is empty, an error will be returned.
  1589.   @{b}Input:@{ub}
  1590.     file - the name of the modulelist to be saved.
  1591.   @{b}Result:@{ub}
  1592.     error = this is an error code where 0 means ok and 1 means error.  Note
  1593.             that the result is in RC not in RESULT.
  1594.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1595.   @{b}Command:@{ub}
  1596.     Shuffle
  1597.   @{b}Description:@{ub}
  1598.     Shuffles the modulelist.
  1599.   @{b}Input:@{ub}
  1600.     None
  1601.   @{b}Result:@{ub}
  1602.     None
  1603.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1604.   @{b}Command:@{ub}
  1605.     SortList
  1606.   @{b}Description:@{ub}
  1607.     Sorts the modulelist in alphabetical order.
  1608.   @{b}Input:@{ub}
  1609.     None
  1610.   @{b}Result:@{ub}
  1611.     None
  1612. @ENDNODE
  1613. ------------------------------------------------------------------------
  1614. @NODE ARPAUSE
  1615. @TITLE "Pause"
  1616.   @{b}Command:@{ub}
  1617.     error = Pause
  1618.   @{b}Description:@{ub}
  1619.     Pauses the current module. If the current  player can't pause or  there
  1620.     aren't any modules in the memory, an error will be returned.
  1621.   @{b}Input:@{ub}
  1622.     None
  1623.   @{b}Result:@{ub}
  1624.     error = this is an error code where 0 means ok and 1 means error.  Note
  1625.             that the result is in RC not in RESULT.
  1626.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1627.   @{b}Command:@{ub}
  1628.     error = TogglePause
  1629.   @{b}Description:@{ub}
  1630.     Toggles the pause state of the current module. If  the  current  player
  1631.     can't pause or there aren't any modules in the memory, an error will be
  1632.     returned.
  1633.   @{b}Input:@{ub}
  1634.     None
  1635.   @{b}Result:@{ub}
  1636.     error = this is an error code where 0 means ok and 1 means error.  Note
  1637.             that the result is in RC not in RESULT.
  1638.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1639.   @{b}Command:@{ub}
  1640.     error = Unpause
  1641.   @{b}Description:@{ub}
  1642.     Starts playing again. If the current player can't pause or there aren't
  1643.     any modules in the memory, an error will be returned.
  1644.   @{b}Input:@{ub}
  1645.     None
  1646.   @{b}Result:@{ub}
  1647.     error = this is an error code where 0 means ok and 1 means error.  Note
  1648.             that the result is in RC not in RESULT.
  1649. @ENDNODE
  1650. ------------------------------------------------------------------------
  1651. @NODE ARPLAY
  1652. @TITLE "Play"
  1653.   @{b}Command:@{ub}
  1654.     Play
  1655.   @{b}Description:@{ub}
  1656.     This will do the same as if you pressed the play button.
  1657.   @{b}Input:@{ub}
  1658.     None
  1659.   @{b}Result:@{ub}
  1660.     None
  1661.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1662.   @{b}Command:@{ub}
  1663.     error = PlayMod @{i}num@{ui}
  1664.   @{b}Description:@{ub}
  1665.     Load and start the module with the number "num" (1 - x) in  the  module
  1666.     list. If the "num" doesn't exist, an error will be returned.
  1667.   @{b}Input:@{ub}
  1668.     num - the number of the module you want to play, starting with 1.
  1669.   @{b}Result:@{ub}
  1670.     error = this is an error code where 0 means ok and 1 means error.  Note
  1671.             that the result is in RC not in RESULT.
  1672.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1673.   @{b}Command:@{ub}
  1674.     error = PlayRNDMod
  1675.   @{b}Description:@{ub}
  1676.     Loads and starts a random module from the list.
  1677.   @{b}Input:@{ub}
  1678.     None
  1679.   @{b}Result:@{ub}
  1680.     error = this is an error code where 0 means ok and 1 means error.  Note
  1681.             that the result is in RC not in RESULT.
  1682.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1683.   @{b}Command:@{ub}
  1684.     error = PlayTune @{i}num@{ui}
  1685.   @{b}Description:@{ub}
  1686.     Start to play the tune "num".  An error is returned if the "num" is out
  1687.     of range. Note that this is for subsongs, like in sid modules.
  1688.   @{b}Input:@{ub}
  1689.     num - the number of the tune you want to play, starting with 1.
  1690.   @{b}Result:@{ub}
  1691.     error = this is an error code where 0 means ok and 1 means error.  Note
  1692.         that the result is in RC not in RESULT.
  1693.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1694.   @{b}Command:@{ub}
  1695.     NextMod
  1696.   @{b}Description:@{ub}
  1697.     Loads and plays the next module in the list. If only one module in  the
  1698.     list,  nothing  will  happend.  If  an error occurs the player will act
  1699.     exactly the same way as if you've pressed the next module button in the
  1700.     main window.
  1701.   @{b}Input:@{ub}
  1702.     None
  1703.   @{b}Result:@{ub}
  1704.     None
  1705.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1706.   @{b}Command:@{ub}
  1707.     PrevMod
  1708.   @{b}Description:@{ub}
  1709.     Loads and plays the Previous module in the list. If only one module  in
  1710.     the  list, nothing will happend. If an error occurs the player will act
  1711.     exactly the same way as if you've pressed the Previous module button in
  1712.     the main window.
  1713.   @{b}Input:@{ub}
  1714.     None
  1715.   @{b}Result:@{ub}
  1716.     None
  1717. @ENDNODE
  1718. ------------------------------------------------------------------------
  1719. @NODE ARRequester
  1720. @TITLE "Requester"
  1721.   @{b}Command:@{ub}
  1722.     dir,success = GetDir @{i}title@{ui}
  1723.   @{b}Description:@{ub}
  1724.     Popups a file requester where the user can pick one directory.  If  the
  1725.     user  selects cancel, "success" will be 1, else it will be 0.
  1726.   @{b}Input:@{ub}
  1727.     title - a string which contains the name of the requester title.
  1728.   @{b}Result:@{ub}
  1729.     dir     - the path the user has selected.
  1730.     success - this is an error code where 0 means ok  and  1  means  error.
  1731.               Note  that the result is in RC not in RESULT.
  1732.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1733.   @{b}Command:@{ub}
  1734.     name,success = GetFile @{i}title@{ui}
  1735.   @{b}Description:@{ub}
  1736.     Popups a file requester where the user can pick one file. If  the  user
  1737.     selects cancel, "success" will be 1, else it will be 0.
  1738.   @{b}Input:@{ub}
  1739.     title - a string which contains the name of the requester title.
  1740.   @{b}Result:@{ub}
  1741.     file    - the filename with path which the user has selected.
  1742.     success - this is an error code where 0 means ok  and  1  means  error.
  1743.               Note that the result is in RC not in RESULT.
  1744.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1745.   @{b}Command:@{ub}
  1746.     num,success = GetNumber @{i}min max title@{ui}
  1747.   @{b}Description:@{ub}
  1748.     Popups a number requester where the user can write  a  number.  If  the
  1749.     user selects cancel, "success" will be 1, else it will be 0.
  1750.   @{b}Input:@{ub}
  1751.     min   - the minimum of the range.
  1752.     max   - the maximum of the range.
  1753.     title - a string which contains the name of the requester title.
  1754.   @{b}Result:@{ub}
  1755.     num     - the number the user has written.
  1756.     success - this is an error code where 0 means ok  and  1  means  error.
  1757.               Note that the result is in RC not in RESULT.
  1758.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1759.   @{b}Command:@{ub}
  1760.     string,success = GetString @{i}title@{ui}
  1761.   @{b}Description:@{ub}
  1762.     Popups a string requester where the user can write  a  string.  If  the
  1763.     user  selects  cancel,  "success"  will  be  1,  else it will be 0. The
  1764.     "string" will be the entered string.
  1765.   @{b}Input:@{ub}
  1766.     title - a string which contains the name of the requester title.
  1767.   @{b}Result:@{ub}
  1768.     string  - the string which the user have typed.
  1769.     success - this is an error code where 0 means ok  and  1  means  error.
  1770.               Note that the result is in RC not in RESULT.
  1771.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1772.   @{b}Command:@{ub}
  1773.     pressed = Request @{i}gadget text@{ui}
  1774.   @{b}Description:@{ub}
  1775.     This will popup a requester where the user can select between a  couple
  1776.     of  gadgets,  like ok and cancel. The "gadget" is a string with all the
  1777.     gadgets you want in the requester seperated with a "|",  ex."ok|cancel"
  1778.     or "yes|maybe|no".
  1779.   @{b}Input:@{ub}
  1780.     gadget - a string with the gadget names.
  1781.     text   - the text which is printed in the requester window.
  1782.   @{b}Result:@{ub}
  1783.     pressed - the number of the gadget which  the  user  has  pressed.  The
  1784.               rightmost gadget is number 0, the  rest  of  the  gadgets  is
  1785.               numbered from left to right.
  1786. @ENDNODE
  1787. ------------------------------------------------------------------------
  1788. @NODE ARsample
  1789. @TITLE "Sample"
  1790.   @{b}Command:@{ub}
  1791.     name,success = GetSampleName @{i}num@{ui}
  1792.   @{b}Description:@{ub}
  1793.     Get the samplename from the sample number "num". If the number  is  out
  1794.     of range then success will be 1, and name will contain crap.
  1795.     The range of numbers could vary from moduleformat to moduleformat.
  1796.   @{b}Input:@{ub}
  1797.     num - the number of the sample from which you want the name.
  1798.   @{b}Result:@{ub}
  1799.     name    - the samplename
  1800.     success - this is an error code where 0 means ok  and  1  means  error.
  1801.               Note that the result is in RC not in RESULT.
  1802.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1803.   @{b}Command:@{ub}
  1804.     success = Savesample @{i}num filename@{ui}
  1805.   @{b}Description:@{ub}
  1806.     Saves the sample "number" with the name  "filename".  This  returns  an
  1807.     error if the sample number is out of range or the size is 0.
  1808.   @{b}Input:@{ub}
  1809.     num      - the samplenumber
  1810.     filename - the name you want the sample to.
  1811.   @{b}Result:@{ub}
  1812.     success - this is an error code where 0 means ok  and  1  means  error.
  1813.               Note that the result is in RC not in RESULT.
  1814.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1815.   @{b}Command:@{ub}
  1816.     StopSample
  1817.   @{b}Description:@{ub}
  1818.     Stops the playing sample.
  1819.   @{b}Input:@{ub}
  1820.     None
  1821.   @{b}Result:@{ub}
  1822.     None
  1823.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1824.   @{b}Command:@{ub}
  1825.     success = PlaySample {i}num note@{ui}
  1826.   @{b}Description:@{ub}
  1827.     Play  the  sample  "num"  with  the note "note". The "num" value can be
  1828.     between  1  and  the  max  number of samples the player can handle. The
  1829.     "note"  value can be between 0 and 35. 0 means C-1 and 35 means B-3. If
  1830.     the current player can't play the sample, an error will be returned.
  1831.   @{b}Input:@{ub}
  1832.     num  - the samplenumber
  1833.     note - the note number
  1834.   @{b}Result:@{ub}
  1835.     success - this is an error code where 0 means ok  and  1  means  error.
  1836.               Note that the result is in RC not in RESULT.
  1837. @ENDNODE
  1838. ------------------------------------------------------------------------
  1839. @NODE ARSpeed
  1840. @TITLE "Speed"
  1841.   @{b}Command:@{ub}
  1842.     speed = GetSpeed
  1843.   @{b}Description:@{ub}
  1844.     Get the current speed slider position and place the result in  "speed".
  1845.     The result is a signed integer.
  1846.   @{b}Input:@{ub}
  1847.     None
  1848.   @{b}Result:@{ub}
  1849.     speed - the current speed
  1850.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1851.   @{b}Command:@{ub}
  1852.     SetSpeed @{i}speed@{ui}
  1853.   @{b}Description:@{ub}
  1854.     Set the speed to "speed". "Speed"  can  range  from  -111  to  112.  If
  1855.     "speed" is  out of range  the  speed  will  be set to either maximum or
  1856.     minimum.
  1857.   @{b}Input:@{ub}
  1858.     speed - the speed to be set
  1859.   @{b}Result:@{ub}
  1860.     None
  1861.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1862.   @{b}Command:@{ub}
  1863.     speed = SpeedDown
  1864.   @{b}Description:@{ub}
  1865.     Move the CIA speed one tick down.
  1866.   @{b}Input:@{ub}
  1867.     None
  1868.   @{b}Result:@{ub}
  1869.     speed - The new speed
  1870.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1871.   @{b}Command:@{ub}
  1872.     speed = SpeedUp
  1873.   @{b}Description:@{ub}
  1874.     Move the CIA speed one tick up.
  1875.   @{b}Input:@{ub}
  1876.     None
  1877.   @{b}Result:@{ub}
  1878.     speed - The new speed
  1879. @ENDNODE
  1880. ------------------------------------------------------------------------
  1881. @NODE ARTechnical
  1882. @TITLE "Technical"
  1883.   @{b}Command:@{ub}
  1884.     author = GetAuthor
  1885.   @{b}Description:@{ub}
  1886.     Returns the author of the current playing module.  If  there  isn't  an
  1887.     author it will return unknown.
  1888.   @{b}Input:@{ub}
  1889.     None
  1890.   @{b}Result:@{ub}
  1891.     author - The name of the author
  1892.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1893.   @{b}Command:@{ub}
  1894.     name = GetChannels
  1895.   @{b}Description:@{ub}
  1896.     Returns the number of  used channels.  This is virtual channels, which
  1897.     means that it can vary from 1 to 32 channels.
  1898.   @{b}Input:@{ub}
  1899.     None
  1900.   @{b}Result:@{ub}
  1901.     type - the number of used channels.
  1902.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1903.   @{b}Command:@{ub}
  1904.     num = GetCMod
  1905.   @{b}Description:@{ub}
  1906.     Returns the current playing module number. 0 if no module is playing.
  1907.   @{b}Input:@{ub}
  1908.     None
  1909.   @{b}Result:@{ub}
  1910.     num - the number of the current module
  1911.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1912.   @{b}Command:@{ub}
  1913.     name = GetFilename @{i}num flag@{ui}
  1914.   @{b}Description:@{ub}
  1915.     Returns the module filename. "num" is the module number in  the  module
  1916.     list. "flag" indicates if you want path. 0 means no, 1 means yes.
  1917.   @{b}Input:@{ub}
  1918.     num  - the module number
  1919.     flag - path or not (see above)
  1920.   @{b}Result:@{ub}
  1921.     name - the filename
  1922.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1923.   @{b}Command:@{ub}
  1924.     info = GetInfo
  1925.   @{b}Description:@{ub}
  1926.     Will return a longword where each bit represent the  information  about
  1927.     the current player. Below is a table of the bits returned.
  1928.     Bit                   Bit
  1929.     0 = Rewind             10 = Length
  1930.     1 = Forward            11 = Position
  1931.     2 = Pause              12 = Max Patterns
  1932.     3 = Volume             13 = Show Samples
  1933.     4 = Fade               14 = Play Samples
  1934.     5 = Tempo              15 = Accompany
  1935.     6 = Channels           16 = Force Filter Off
  1936.     7 = Modulename         17 = FastMem
  1937.     8 = Author             18 = Own Config
  1938.     9 = SubSongs           19 = Noteplayer
  1939.   @{b}Input:@{ub}
  1940.     None
  1941.   @{b}Result:@{ub}
  1942.     info - a number containing the above bits
  1943.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1944.   @{b}Command:@{ub}
  1945.     len = GetLength
  1946.   @{b}Description:@{ub}
  1947.     Get the length of the current  playing  module.  If  the  length  isn't
  1948.     available 0 will be returned.
  1949.   @{b}Input:@{ub}
  1950.     None
  1951.   @{b}Result:@{ub}
  1952.     len - the song length
  1953.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1954.   @{b}Command:@{ub}
  1955.     max = GetMaxPatterns
  1956.   @{b}Description:@{ub}
  1957.     Returns the number of patterns in the current playing  module.  If  the
  1958.     number of patterns isn't available 0 will be returned.
  1959.   @{b}Input:@{ub}
  1960.     None
  1961.   @{b}Result:@{ub}
  1962.     max - number of patterns
  1963.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1964.   @{b}Command:@{ub}
  1965.     max = GetMaxSamples
  1966.   @{b}Description:@{ub}
  1967.     Returns the max number of samples the current player can handle. If the
  1968.     player can't handle any samples, 0 will be returned.
  1969.   @{b}Input:@{ub}
  1970.     None
  1971.   @{b}Result:@{ub}
  1972.     max - the max number of samples
  1973.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1974.   @{b}Command:@{ub}
  1975.     max = GetMaxTunes
  1976.   @{b}Description:@{ub}
  1977.     Get the max number of tunes in the  current  playing  module.  It  will
  1978.     return 0 if there isn't a module in memory.
  1979.   @{b}Input:@{ub}
  1980.     None
  1981.   @{b}Result:@{ub}
  1982.     max - the number of tunes
  1983.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1984.   @{b}Command:@{ub}
  1985.     rate = GetMixingRate
  1986.   @{b}Description:@{ub}
  1987.     This get the actual mixing rate used by the  used  noteplayer. It  will
  1988.     return  0  if  there isn't a module in memory or if no noteplayer, with
  1989.     mixing routines, is in use.
  1990.   @{b}Input:@{ub}
  1991.     None
  1992.   @{b}Result:@{ub}
  1993.     rate - The mixing rate
  1994.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1995.   @{b}Command:@{ub}
  1996.     name = GetName
  1997.   @{b}Description:@{ub}
  1998.     Returns the name of  the  current  playing  module.  This  is  not  the
  1999.     filename  but the name of the module taken from the module. If it isn't
  2000.     available it will return the filename.
  2001.   @{b}Input:@{ub}
  2002.     None
  2003.   @{b}Result:@{ub}
  2004.     name - the module name
  2005.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  2006.   @{b}Command:@{ub}
  2007.     name = GetNotePlayer
  2008.   @{b}Description:@{ub}
  2009.     Returns the name of the current noteplayer.
  2010.   @{b}Input:@{ub}
  2011.     None
  2012.   @{b}Result:@{ub}
  2013.     type - the noteplayer name
  2014.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  2015.   @{b}Command:@{ub}
  2016.     type = GetPlayer
  2017.   @{b}Description:@{ub}
  2018.     Returns the name of the current used player library, eg. Protracker or
  2019.     Future Composer.
  2020.   @{b}Input:@{ub}
  2021.     None
  2022.   @{b}Result:@{ub}
  2023.     type - the player name
  2024.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  2025.   @{b}Command:@{ub}
  2026.     mode = GetPlayMode
  2027.   @{b}Description:@{ub}
  2028.     Get the current playing state. The result is  a  boolean  and  1  means
  2029.     VBlank and 0 means CIA.
  2030.   @{b}Input:@{ub}
  2031.     None
  2032.   @{b}Result:@{ub}
  2033.     mode - the current playing state
  2034.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  2035.   @{b}Command:@{ub}
  2036.     pos = GetPosition
  2037.   @{b}Description:@{ub}
  2038.     Get the current position. If the current player can't get the position,
  2039.     -1 will be returned.
  2040.   @{b}Input:@{ub}
  2041.     None
  2042.   @{b}Result:@{ub}
  2043.     pos - the current position
  2044.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  2045.   @{b}Command:@{ub}
  2046.     size = GetSize
  2047.   @{b}Description:@{ub}
  2048.     Get the filesize (unpacked) in bytes of the current playing module.
  2049.   @{b}Input:@{ub}
  2050.     None
  2051.   @{b}Result:@{ub}
  2052.     size - the module size
  2053.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  2054.   @{b}Command:@{ub}
  2055.     tune = GetTune
  2056.   @{b}Description:@{ub}
  2057.     Get the current playing tune number.
  2058.   @{b}Input:@{ub}
  2059.     None
  2060.   @{b}Result:@{ub}
  2061.     tune - the current tune number
  2062.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  2063.   @{b}Command:@{ub}
  2064.     success = SetAuthor @{i}author@{ui}
  2065.   @{b}Description:@{ub}
  2066.     Change the author. It will return an error if no module is in memory.
  2067.   @{b}Input:@{ub}
  2068.     author - the new author name
  2069.   @{b}Result:@{ub}
  2070.     success - this is an error code where 0 means ok  and  1  means  error.
  2071.               Note that the result is in RC not in RESULT.
  2072.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  2073.   @{b}Command:@{ub}
  2074.     success = SetName @{i}name@{ui}
  2075.   @{b}Description:@{ub}
  2076.     Change  the  module  name.  It  will return an error if no module is in
  2077.     memory.
  2078.   @{b}Input:@{ub}
  2079.     name - the new module name
  2080.   @{b}Result:@{ub}
  2081.     success - this is an error code where 0 means ok  and  1  means  error.
  2082.               Note that the result is in RC not in RESULT.
  2083. @ENDNODE
  2084. ------------------------------------------------------------------------
  2085. @NODE ARvarious
  2086. @TITLE "Various"
  2087.   @{b}Command:@{ub}
  2088.     Filter @{i}State@{ui}
  2089.   @{b}Description:@{ub}
  2090.     Turn on or off the filter. 1 means on and 0 means off.
  2091.   @{b}Input:@{ub}
  2092.     state - the filter state
  2093.   @{b}Result:@{ub}
  2094.     None
  2095.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  2096.   @{b}Command:@{ub}
  2097.     Quit
  2098.   @{b}Description:@{ub}
  2099.     This will quit APlayer immediately.
  2100.   @{b}Input:@{ub}
  2101.     None
  2102.   @{b}Result:@{ub}
  2103.     None
  2104. @ENDNODE
  2105. ------------------------------------------------------------------------
  2106. @NODE ARVolume
  2107. @TITLE "Volume"
  2108.   @{b}Command:@{ub}
  2109.     vol = GetVolume
  2110.   @{b}Description:@{ub}
  2111.     Get  the  current  volume and place the result in "vol". If the current
  2112.     player can't change the volume, the result will be 64.
  2113.   @{b}Input:@{ub}
  2114.     None
  2115.   @{b}Result:@{ub}
  2116.     vol - the current volume
  2117.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  2118.   @{b}Command:@{ub}
  2119.     SetVolume @{i}vol@{ui}
  2120.   @{b}Description:@{ub}
  2121.     Set the volume to "vol". If the number is out of range the volume would
  2122.     be set to either max or min.
  2123.   @{b}Input:@{ub}
  2124.     vol - the new volume
  2125.   @{b}Result:@{ub}
  2126.     None
  2127.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  2128.   @{b}Command:@{ub}
  2129.     vol = VolumeDown
  2130.   @{b}Description:@{ub}
  2131.     Move the volume one tick down. It will return the new volume.
  2132.   @{b}Input:@{ub}
  2133.     None
  2134.   @{b}Result:@{ub}
  2135.     vol - the new volume
  2136.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  2137.   @{b}Command:@{ub}
  2138.     vol = VolumeUp
  2139.   @{b}Description:@{ub}
  2140.     Move the volume one tick up. It will return the new volume.
  2141.   @{b}Input:@{ub}
  2142.     None
  2143.   @{b}Result:@{ub}
  2144.     vol - the new volume
  2145. @ENDNODE
  2146. ------------------------------------------------------------------------
  2147. @NODE ARWind
  2148. @TITLE "Wind"
  2149.   @{b}Command:@{ub}
  2150.     Forward
  2151.   @{b}Description:@{ub}
  2152.     Step one pattern forward. The same as pressing the forward button.
  2153.   @{b}Input:@{ub}
  2154.     None
  2155.   @{b}Result:@{ub}
  2156.     None
  2157.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  2158.   @{b}Command:@{ub}
  2159.     Rewind
  2160.   @{b}Description:@{ub}
  2161.     Step one pattern backward. The same as pressing the rewind button.
  2162.   @{b}Input:@{ub}
  2163.     None
  2164.   @{b}Result:@{ub}
  2165.     None
  2166. @ENDNODE
  2167. ------------------------------------------------------------------------
  2168. @NODE ARWindow
  2169. @TITLE "Window"
  2170.    @{b}Command:@{ub}
  2171.     screen = GetScreen
  2172.    @{b}Description:@{ub}
  2173.     Returns  the  name  of  the  screen APlayer is active on. If APlayer is
  2174.     iconified,  it will return 1 in RC, else it will return 0 in RC and the
  2175.     screen name in RESULT.
  2176.    @{b}Input:@{ub}
  2177.     None
  2178.    @{b}Result:@{ub}
  2179.     screen - Name of the screen.
  2180.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  2181.   @{b}Command:@{ub}
  2182.     Iconify
  2183.   @{b}Description:@{ub}
  2184.     Iconify APlayer with an AppIcon.
  2185.   @{b}Input:@{ub}
  2186.     None
  2187.   @{b}Result:@{ub}
  2188.     None
  2189.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  2190.   @{b}Command:@{ub}
  2191.     Popup
  2192.   @{b}Description:@{ub}
  2193.     Popup the main window.
  2194.   @{b}Input:@{ub}
  2195.     None
  2196.   @{b}Result:@{ub}
  2197.     None
  2198.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  2199.    @{b}Command:@{ub}
  2200.      success = SetScreen screen
  2201.    @{b}Description:@{ub}
  2202.      Opens  the APlayer window on another public screen. If the screen does
  2203.      not  exist  or  isn't public, APlayer will return an error and stay on
  2204.      its previous screen.
  2205.    @{b}Input:@{ub}
  2206.      screen - Name of public screen (case sensitive!)
  2207.    @{b}Result:@{ub}
  2208.      success - This is an error code where 0 means ok  and  1  means error.
  2209.                Note that the result is in RC not in RESULT.
  2210. @ENDNODE
  2211. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2212. @Font topaz.font 8
  2213. @Node cfg
  2214. @TITLE "Configuration Window"
  2215.  _________________________________________________________________________
  2216. |  ______________________________________________________________________ |
  2217. | |o|                      @{" Configuration Cycle " LINK cfgMaincycle}                       | |
  2218. |                                                                         |
  2219. |                         - Here you change many -                        |
  2220. |                          - different options. -                         |
  2221. |                                                                         |
  2222. |                              - To see how -                             |
  2223. |                        - press the button above -                       |
  2224. |                                                                         |
  2225. |                                                                         |
  2226. |                                                                 @{"x/x < >" LINK cfgPages}|
  2227. | @{" Players " LINK cfgPlayers}                  @{" Noteplayers " LINK cfgplayers}                     @{" Agents " LINK cfgplayers}|
  2228. |                                                                         |
  2229. | @{"  Save   " LINK cfgsaveusecancel}                  @{"     Use     " LINK cfgsaveusecancel}                     @{" Cancel " LINK cfgsaveusecancel}|
  2230. |_________________________________________________________________________|
  2231.  Click @{"here" LINK prefsmenu} to see how to use the menus in this window.
  2232. @ENDNODE
  2233. -------------------------------------------------------------------------------
  2234. @Font screenfont 8
  2235. @NODE cfgMaincycle
  2236. @TITLE "Main Configuration Cycle"
  2237.   @{"Options" LINK cfgOptions}  @{" 2 " LINK cfgoptions2} : Set and toggle several options.
  2238.   @{" Paths " LINK cfgPaths} : Here you can decide where from APlayer should get it's files.
  2239.   @{"Hotkeys" LINK cfgHotkeys} : Change the hotkey definitions of APlayer.
  2240.   @{" ARexx " LINK cfgARexx} : Configure the ARexx part of APlayer.
  2241.   @{"Windows/Screens" LINK cfgwindowsscreens} : Change Aplayers positions and layout.
  2242.   @{"Unpack" LINK cfgUnpack} : Which packers/archivers should APlayer recognize ?
  2243. @ENDNODE
  2244. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2245. @Font topaz.font 8
  2246. @NODE cfgOptions
  2247. @TITLE "Configurations Options"
  2248.   @{b}Options Configuration page @{i}1 @{ui}:@{ub}
  2249.   ________________________________________________________________________
  2250.  |                                                                        |
  2251.  |  @{"  " LINK Loadlibraries} @{u}L@{uu}oad Libraries     @{"\/" LINK Expungelibraries} E@{u}x@{uu}punge Libraries       @{"\/" LINK tipoftheday} T@{u}i@{uu}p of the Day |
  2252.  |                                                                        |
  2253.  |  @{"\/" LINK AllocateChannels} All@{u}o@{uu}cate Channels  @{"  " LINK Jumptoaddedmodule} @{u}J@{uu}ump To Loaded Module   @{"\/" LINK OnlineHelp} Online @{u}H@{uu}elp    |
  2254.  |                                                                        |
  2255.  |  @{"  " LINK VBlankInterrupt} @{u}V@{uu}Blank Interrupt   @{"  " LINK forcefilteroff} Force @{u}F@{uu}ilter Off                           |
  2256.  |________________________________________________________________________|
  2257.  |                                                                        |
  2258.  |  @{"  " LINK Doublebuffering} @{u}D@{uu}ouble Buffering     Early Load: @{"ooo                           " LINK earlyload} 1|
  2259.  |________________________________________________________________________|
  2260.  |                                                                        |
  2261.  |  @{"  " LINK FademoduleAtEnd} Fade @{u}M@{uu}odule At End                         @{"  " LINK FadeAtPause} Fade At Pause/Nex@{u}t@{uu} |
  2262.  |                                                                        |
  2263.  |  Fade Speed: @{"oooooooooo                                             " LINK FadeSpeed} 1|
  2264.  |________________________________________________________________________|
  2265.  |                                                                        |
  2266.  |                E@{u}r@{uu}ror Messages: @{"     All     " LINK Errormessages}                  1/2 < @{">" LINK cfgoptions2}|
  2267.  |________________________________________________________________________|
  2268. @ENDNODE
  2269. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2270. @Font screenfont 8
  2271. @Node LoadLibraries
  2272. @TITLE "Load Libraries"
  2273.   @{u}@{b}Load Libraries:@{ub}@{uu}
  2274.   This gadget will cause APlayer  to load the selected  unpack library, all
  2275.   noteplayers,  agents  and   all  the  player  libraries, defined  in  the
  2276.   @{"player-configuration" LINK cfgplayers}, the  first  time APlayer is  started. This  will of
  2277.   course use more memory, but  it will  also  give  faster  access  to  all
  2278.   player libraries which means quicker moduleload.
  2279.   It can also come in handy for people without harddisk, because loading of
  2280.   all  player  libraries  at  start  avoids  a  lot  of diskswapping during
  2281.   module-load.
  2282. @{b}  Default is OFF.@{ub}
  2283. @ENDNODE
  2284. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2285. @Node AllocateChannels
  2286. @TITLE "Allocate Channels"
  2287.   @{u}@{b}Allocate Channels:@{ub}@{uu}
  2288.   With this gadget ON you can prevent other music programs from interfering
  2289.   with  the  audiochannels.  If you change  the  state  of  this gadget the 
  2290.   channels will be (de)allocated when the next module is loaded.
  2291.   That is, the  channels will  always be  allocated as  long as there  is a
  2292.   module in memory.
  2293. @{b}  Default is ON.@{ub}
  2294. @ENDNODE
  2295. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2296. @Node VBlankInterrupt
  2297. @TITLE "VBlank Interrupt"
  2298.   @{u}@{b}VBlank Interrupt:@{ub}@{uu}
  2299.   This gadget is used to help people who's  still  using  SoundTracker  and
  2300.   NoiseTracker  modules,  containing  VBlank speed commands bigger than 1F.
  2301.   These can under normal conditions sound to slow, played by  this  player.
  2302.   But  checking  this  gadget, will cause the player to interpret all speed
  2303.   commands in the module as VBlank speed commands, which will  correct  the
  2304.   speed errors.
  2305. @{b}  Default is OFF.@{ub}
  2306. @ENDNODE
  2307. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2308. @Node ExpungeLibraries
  2309. @TITLE "Expunge Libraries"
  2310.   @{u}@{b}Expunge Libraries:@{ub}@{uu}
  2311.   With this checkmark you can decide wether  the  memory  used  by  already
  2312.   loaded libraries  should  be  released or not, when you quit the program.
  2313.   If you often quit and reload the APlayer, then this button will help you.
  2314.   As  it  will  prevent the player libraries, agents  and noteplayers  from
  2315.   being  loaded everytime  you restart  the player  and load a  new kind of
  2316.   module.
  2317.   Because most people want  to  have  as  much  memory  as  possible,  this
  2318.   function is by default set to ON.
  2319. @{b}  Default is ON.@{ub}
  2320. @ENDNODE
  2321. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2322. @Node Jumptoaddedmodule
  2323. @TITLE "Jump To added Module"
  2324.   @{u}@{b}Jump To Loaded Module:@{ub}@{uu}
  2325.   If there  are  modules already  in the modulelist and you press the  PLAY
  2326.   button, and select a number of files, they will automatically be added to
  2327.   the end of the list. With this function set to ON, APlayer will be forced
  2328.   to load and play the first selected module (in the filerequester).
  2329. @{b}  Default is OFF.@{ub}
  2330. @ENDNODE
  2331. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2332. @Node ForceFilteroff
  2333. @TITLE "Force Filter Off"
  2334.   @{u}@{b}Force Filter Off:@{ub}@{uu}
  2335.   This will force APlayer to keep  the  audiofilter  turned  off.  This  is
  2336.   useful  for  old  noisetracker modules which used one command to turn the
  2337.   filter on/off instead of the new protracker which uses two  different  to
  2338.   do so.
  2339. @{b}  Default is OFF.@{ub}
  2340.   @{b}NOTE: This function is not supported by all moduletypes. See @{"module types" LINK modtypes}.@{ub} 
  2341. @ENDNODE
  2342. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2343. @Node Tipoftheday
  2344. @TITLE "Tip of The Day"
  2345.   @{u}@{b}Tip of The Day:@{uu}@{ub}
  2346.   This option, if on, will make APlayer open a window every time it  starts
  2347.   up.  The  window  will  display  a  randomly  selected hint on the use of
  2348.   APlayer, to help you use APlayer's many functions to their full extent.
  2349. @ENDNODE
  2350. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2351. @NODE OnlineHelp
  2352. @TITLE "Online Help"
  2353.   @{u}@{b}Online Help:@{uu}@{ub}
  2354.   Online Help in APlayer is only a Help-click away with this turned on :)
  2355.   Place the  mouse pointer on the  thing (Gadget, list, whatever) and press
  2356.   the HELP-key.
  2357.   Remember that to show the online help, APlayer needs the APlayer.guide to
  2358.   be  in  "progdir:docs/APlayer.guide" That is, it has to be in a directory
  2359.   placed along with APlayer called "docs".
  2360.   If you have used the APlayer installer to install the program, everything
  2361.   should be placed correctly and you won't have to worry about it.
  2362. @ENDNODE
  2363. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2364. @Node DoubleBuffering
  2365. @TITLE "Double Buffering"
  2366.   @{u}@{b}Double Buffering:@{ub}@{uu}
  2367.   This function will cause the APlayer to load the next module in the list,
  2368.   while  the  current  module  still  plays. This will normally prevent the
  2369.   silence between two modules. If you don't check this one, you  will  save
  2370.   some  ram, but you will have to wait in silence for the next module to be
  2371.   loaded and started.
  2372.   See also @{"Early Load" LINK earlyload} for more info on this.
  2373. @{b}  Default is OFF.@{ub}
  2374. @ENDNODE
  2375. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2376. @NODE EarlyLoad
  2377. @TITLE "Early Load"
  2378.   @{b}Early Load:@{ub} This  slider is used in conjuction with the @{"double buffering" LINK Doublebuffering}
  2379.               function.   The  value  (1-9)  indicates  how  many  patterns
  2380.               (positions) before the module ends, the next module should be
  2381.               loaded. For harddisk users a value of 1 is enough, but if you
  2382.               use a diskdrive, you will have to set it to 3 or 4, dependent
  2383.               of the modulesizes.
  2384. @ENDNODE
  2385. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2386. @Node FademoduleatEnd
  2387. @TITLE "Fade Module At End"
  2388.   @{u}@{b}Fade Module At End:@{ub}@{uu}
  2389.   This flag will cause the player to automatically fade the module at end.
  2390.   See also @{"Fade Speed" LINK fadespeed}.
  2391. @{b}  Default is OFF.@{ub}
  2392.   @{b}NOTE: This function isn't supported by all moduletypes. See @{"module types" LINK modtypes}.@{ub}
  2393. @ENDNODE
  2394. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2395. @Node FadeatPause
  2396. @TITLE "Fade At Pause/Next"
  2397.   @{u}@{b}Fade At Pause/Next:@{ub}@{uu}
  2398.   This flag will cause the player to automatically fade the module when the
  2399.   user  hits  the  "next module"- or the "pause"-gadget in the main window.
  2400.   Note that releasing the "pause" button again  will  fade  up  the  volume
  2401.   again.
  2402. @{b}  Default is OFF.@{ub}
  2403.   @{b}NOTE: This function is not supported by all moduletypes. See @{"module types" LINK modtypes}.@{ub} 
  2404. @ENDNODE
  2405. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2406. @Node FadeSpeed
  2407. @TITLE "Fade Speed"
  2408.   @{b}Fade Speed:@{ub} Use  this  slider  to  choose how fast the fading of a module
  2409.               should  be.  1 is the fastest and 4 is the slowest. Note that
  2410.               this will only affect the @{"Fade Module At End" LINK fademoduleatend}.
  2411. @ENDNODE
  2412. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2413. @Node ErrorMessages
  2414. @TITLE "Error Messages"
  2415.   @{u}@{b}Error Requesters:@{ub}@{uu}
  2416.   With this selector you can choose which error messages you want to see.
  2417.   @{b}All@{ub}     : Both APlayer and Dos errors.
  2418.   @{b}APlayer@{ub} : Unknown  moduletype, out of mem, decrunch  error, couldn't find
  2419.             Arexx, Channel allocation error aso.
  2420.   @{b}Dos@{ub}     : read/write error, file not found etc
  2421.   @{b}None@{ub}    : None of the above
  2422.   The Dos-errors will always delete the module from the list  (no  use  for
  2423.   crap files in the list, or..).
  2424.   If you choose not to see the APlayer errors, APlayer  will  usually  just
  2425.   skip the module, instead of deleting it from the list.
  2426. @ENDNODE
  2427. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2428. @Font topaz.font 8
  2429. @NODE cfgoptions2
  2430. @TITLE "Configuration Options Page 2"
  2431.   @{b}Options Configuration page @{i}2 @{ui}:@{ub}
  2432.   ________________________________________________________________________
  2433.  |                   ___________________________________________________  |
  2434.  |    @{"Cut Prefixes" LINK cutprefixes}:|@{u}mod.|mdat.@{uu}_________________________________________| |
  2435.  |                   ___________________________________________________  |
  2436.  |  @{"Module Pattern" LINK Modulepattern}:|@{u}~(SMPL.#?|#?.nt|#?.ins)@{uu}____________________________| |
  2437.  |                   ________________________________________________     |
  2438.  |        @{"App Icon" LINK cfgAppIcon}:|________________________________________________| @{"o" LINK Disk} |
  2439.  |________________________________________________________________________|
  2440.  |                                                                        |
  2441.  | @{"  " LINK Timeout} Ne@{u}v@{uu}er Ending Module Timeout: @{" 120" LINK Timeoutvalue} seconds                         |
  2442.  |                                                                        |
  2443.  | At @{u}E@{uu}nd of Modulelist: @{"@|           Jump to start             " LINK endmodulelist} 2/2 @{"<" LINK cfgoptions} >|
  2444.  |________________________________________________________________________|
  2445. @ENDNODE
  2446. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2447. @Font screenfont 8
  2448. @NODE CutPrefixes
  2449. @TITLE "Cut Prefixes"
  2450.   @{b}Cut Prefixes:@{ub}
  2451.    As  you  have  maybe  noticed, there  isn't  much  space  left  for  the
  2452.    modulenames in the main window. This is because most moduletypes usually
  2453.    are  classified  by a file prefix,  e.g. "mod."  This string  is used to
  2454.    define  which prefixes  APlayer should cut  automatically from the list.
  2455.    The format is like this: Prefix1|Prefix2|Prefix3  etc. (notice  the  "|"
  2456.    (pipe) between the different prefixes!)
  2457.    If you don't want anything to be left out, just leave this string empty.
  2458.    Please note that this string can have a maximum length of 256 chars.
  2459. @ENDNODE
  2460. --------------------------------------------------------------------------------
  2461. @NODE Modulepattern
  2462. @TITLE "ModulePattern"
  2463.   @{b}@{u}Module Pattern:@{ub}@{uu}
  2464.    Here you can define the filepattern in the filerequester when  you  load
  2465.    modules.  Default is ~(SMPL.#?|#?.nt|#?.ins) which means that all files,
  2466.    except files  starting with "smpl.", ending  with ".nt" or ".ins" should
  2467.    be displayed.
  2468. @ENDNODE
  2469. ---------------------------------------------------------------------------------
  2470. @NODE cfgAppIcon
  2471. @TITLE "AppIcon"
  2472.   @{u}@{b}Configure App-Icon:@{ub}@{uu}
  2473.   If you don't like the supplied @{"app-icon" LINK app-icon}(sheep power :) then you can pick
  2474.   an icon of your own to be used as APlayers App-icon.
  2475.   If the specified icon file cannot be found, APlayer will be forced to use
  2476.   @{b}sheep@{ub} power though :)
  2477.   @{b}NOTE: If  you  don't  have  the  Newicons  patch  installed  DO  NOT!,  I
  2478.         repeat,  DO NOT USE A NEWICON AS AN APPICON, IT WILL MAKE WORKBENCH
  2479.         CRASH. (At best :)@{ub}
  2480. @ENDNODE
  2481. ---------------------------------------------------------------------------------
  2482. @NODE Timeout
  2483. @TITLE "Never Ending Module Timeout"
  2484.   @{b}@{u}Never Ending Module Timeout:@{uu}@{ub}
  2485.   Selecting this will cause APlayer  to  automatically  skip  to  the  next
  2486.   module  after the given number of @{"seconds" LINK timeoutvalue}, if the module doesn't support
  2487.   @{"positions" LINK modtypes}.
  2488. @ENDNODE
  2489. ---------------------------------------------------------------------------------
  2490. @NODE timeoutvalue
  2491. @TITLE "Never Ending Module Timeout Value"
  2492.   @{b}@{u}Timeout Value:@{uu}@{ub}
  2493.   Here you can specify how many seconds the module should be played, before
  2494.   APlayer skips to the next module.
  2495.   Values from 1 to 9999 seconds (02hr, 46min and 39secs) is supported.
  2496. @ENDNODE
  2497. ---------------------------------------------------------------------------------
  2498. @NODE EndModulelist
  2499. @TITLE "What to do at end of modulelist""
  2500.   @{b}@{u}End of Modulelist:@{uu}@{ub}
  2501.   When APlayer reaches the bottom of the module  list,  that  is  when  the
  2502.   module  is  finished,  you  can choose between three actions, what should
  2503.   happen:
  2504.  Jump to start : Will start to play the modulelist over again. (default)
  2505.  Loop module   : Will loop the last module in the list over and over ..
  2506.  Eject module  : Ejects the played module from memory.
  2507. @ENDNODE
  2508. ---------------------------------------------------------------------------------
  2509. @Font topaz.font 8
  2510. @NODE cfgPaths
  2511. @TITLE "Paths Configuration"
  2512.  @{u}@{b}Paths Configuration:@{uu}@{ub}
  2513.   ________________________________________________________________________
  2514.  |                   ________________________________________________     |
  2515.  | @{"Start Scan Path" LINK startscanpath}:|________________________________________________| @{"o" LINK disk} |
  2516.  |                   ________________________________________________     |
  2517.  |     @{"Module Path" LINK modulepath}:|________________________________________________| @{"o" LINK disk} |
  2518.  |                   ________________________________________________     |
  2519.  |       @{"APML Path" LINK APMLpath}:|@{u}S:@{uu}______________________________________________| @{"o" LINK disk} |
  2520.  |                   ________________________________________________     |
  2521.  |       @{"Temp Path" LINK Temppath}:|@{u}T:@{uu}______________________________________________| @{"o" LINK disk} |
  2522.  |________________________________________________________________________|
  2523. @ENDNODE
  2524. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2525. @Font screenfont 8
  2526. @NODE startscanpath
  2527. @TITLE "Start Scan Path"
  2528.   @{b}Start Scan Path:@{ub}
  2529.    In this string you may specify a directory, which  will be  scanned  for
  2530.    modules  when  you start the APlayer. The modules will be shuffled and a
  2531.    random module will be chosen and played.  This will of course also cause
  2532.    lha  archives  to be unarchived. If you don't want this to happen, leave
  2533.    this string empty.
  2534. @ENDNODE
  2535. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2536. @NODE modulepath
  2537. @TITLE "Module Path"
  2538.   @{b}Module Path:@{ub}
  2539.    This tells APlayer where you want it to look for your modules.  You  can
  2540.    use  the  diskgadget  to  the  right  to  choose  the  modulepath from a
  2541.    file-requester.
  2542. @ENDNODE
  2543. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2544. @NODE APMLpath
  2545. @TITLE "APML Path"
  2546.   @{b}APML Path:@{ub}
  2547.    This tells APlayer where you keep your modulelist files. You can use the
  2548.    diskgadget  to the right to choose the modulepath from a file-requester.
  2549.    Default is S:
  2550. @ENDNODE
  2551. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2552. @NODE Temppath
  2553. @TITLE Temp Path"
  2554.   @{b}Temp Path:@{ub} 
  2555.    This is the path which APlayer will use to unpack crunched  files, store
  2556.    lha files  and so on. You can use the  diskgadget to the right to choose
  2557.    choose the modulepath from a file-requester. Default is T:
  2558. @ENDNODE
  2559. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2560. @Font topaz.font 8
  2561. @NODE cfgHotkeys
  2562. @TITLE "Hotkeys Configuration"
  2563.   ________________________________________________________________________
  2564.  |                         ______________________________________________ |
  2565.  | @{"App Popup/Hide Hotkey" LINK apppopup}:|@{u}control shift a@{uu}_______________________________||
  2566.  |                         ______________________________________________ |
  2567.  |     @{"Popup/Hide Hotkey" LINK popuphide}:|@{u}control alt a@{uu}_________________________________||
  2568.  |                         ______________________________________________ |
  2569.  | @{"Hotkey To Skip Module" LINK skiphotkey}:|@{u}control alt space@{uu}_____________________________||
  2570.  |________________________________________________________________________|
  2571.  |                                                                        |
  2572.  |         @{"Config" LINK hotkeyconfiglist}                   @{"Show" LINK hotkeyshowlist}                @{"Used Hotkeys" LINK usedhotkeyslist}   |
  2573.  ||                      ||                      ||                      ||
  2574.  ||                      ||                      ||                      ||
  2575.  ||                      ||                      ||                      ||
  2576.  ||______________________||______________________||______________________||
  2577.  |                            __________________________________          |
  2578.  | @{"  Update Lists  " LINK updatelists} @{"Hotkey" LINK hotkey}:|                                  | 1/1 < > |
  2579.  |                            
  2580.           |
  2581. @ENDNODE
  2582. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2583. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2584. @Font screenfont 8
  2585. @Node apppopup
  2586. @TITLE "Configuration - App Popup/Hide Hotkey"
  2587.   @{b}App Popup/Hide Hotkey:@{ub}
  2588.   This string contains the hotkey for the  APlayer  Program.  Pressing  the
  2589.   defined hotkey will close all open APlayer windows, and popup an app-icon
  2590.   on the workbench. See @{"app-icon" link app-icon}.
  2591.   @{b}NOTE: Any valid commodity hotkey can be used for these hotkeys.@{ub}
  2592. @ENDNODE
  2593. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2594. @NODE popuphide
  2595. @TITLE "Configuration - Popup/Hide Hotkey"
  2596.   @{b}Popup/Hide Hotkey:@{ub}
  2597.   This is  nearly exactly the same as the "App Popup/Hide" hotkey, but this
  2598.   will NOT popup an app-icon on workbench. See @{"app-icon" link app-icon}.
  2599.   @{b}NOTE: Any valid commodity hotkey can be used for these hotkeys.@{ub}
  2600. @ENDNODE
  2601. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2602. @NODE skiphotkey
  2603. @TITLE "Configuration - Hotkey To Skip Module"
  2604.   @{b}Hotkey To Skip Module:@{ub}
  2605.   Pressing the defined hotkey will  be  the  same  as  pressing  the  "next
  2606.   module" gadget in the main window.
  2607.   @{b}NOTE: Any valid commodity hotkey can be used for these hotkeys.@{ub}
  2608. @ENDNODE
  2609. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2610. @NODE hotkeyconfiglist
  2611. @TITLE "Configuration Hotkeys"
  2612.   @{b}Config:@{ub}
  2613.   This list displays all players,  noteplayers  and  agents  which  have  a
  2614.   configuration  window assigned  to them. Pressing one of the entries will
  2615.   allow you to change the @{"hotkey" LINK hotkey} for the chosen item.
  2616.   Defining a hotkey for i.e. a player config will allow you to  access  and
  2617.   change  the  configuration  for the given player at any time, so that you
  2618.   won't have to enter the  APlayer  configuration  everytime  you  want  to
  2619.   change something.
  2620. @ENDNODE
  2621. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2622. @NODE hotkeyshowlist
  2623. @TITLE "Show Hotkeys"
  2624.   @{b}Show:@{ub}
  2625.   This list displays all players, noteplayers and agents which have a  show
  2626.   window  assigned to  them. Pressing  one of the entries will allow you to
  2627.   change the @{"hotkey" LINK hotkey} for the chosen item.
  2628.   Defining a hotkey for i.e. an Agents show window will allow you make  the
  2629.   agent appear everytime you press the defined hotkey.
  2630. @ENDNODE
  2631. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2632. @NODE usedhotkeyslist
  2633. @TITLE "Used Hotkeys"
  2634.   @{b}Used Hotkeys@{ub}
  2635.   This is a list of all used hotkeys. Simple but that's right :)
  2636.   APlayer will automically check if you have used the  same  hotkey  twice,
  2637.   but  only  if they are spelt the same way. That is, "control a" and "ctrl
  2638.   a" will not be the same hotkey to APlayer. If you  have  two  identically
  2639.   hotkeys  then the player, noteplayer or agent which is displayed first in
  2640.   the list, will be activated.
  2641. @ENDNODE
  2642. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2643. @NODE Updatelists
  2644. @TITLE "Update Lists"
  2645.   @{b}Update Lists:@{ub}
  2646.   When you press this button all player libraries, noteplayers  and  agents
  2647.   will be scanned  to see if they have a config  or a show window, and then
  2648.   which hotkeys they eventually uses.
  2649.   All the information will then be printed in the three lists above.
  2650. @ENDNODE
  2651. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2652. @NODE Hotkey
  2653. @TITLE "Hotkey Definition"
  2654.   @{b}Hotkey:@{ub}
  2655.   This is where you describe the hotkey for the chosen  player,  noteplayer
  2656.   or agent. The hotkey can be any legal commodity hotkey.
  2657. @ENDNODE
  2658. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2659. @Font topaz.font 8
  2660. @NODE cfgARexx
  2661. @TITLE "ARexx Configuration"
  2662.   ________________________________________________________________________
  2663.  | @{"  " LINK ActivateArexx} Activate ARex@{u}x@{uu}                                            @{" Clear " LINK ARexxClear} |
  2664.  | @{"@|                                SHIFT                              " LINK ARexxcycle} |
  2665.  |      ___________________________           _________________________   |
  2666.  | @{"F1" LINK F1} |___________________________|@{"o" LINK DISK}   @{"F6" LINK F1} |_________________________|@{"o" LINK DISK}|
  2667.  |      ___________________________           _________________________   |
  2668.  | @{"F2" LINK F1} |___________________________|@{"o" LINK DISK}   @{"F7" LINK F1} |_________________________|@{"o" LINK DISK}|
  2669.  |      ___________________________           _________________________   |
  2670.  | @{"F3" LINK F1} |___________________________|@{"o" LINK DISK}   @{"F8" LINK F1} |_________________________|@{"o" LINK DISK}|
  2671.  |      ___________________________           _________________________   |
  2672.  | @{"F4" LINK F1} |___________________________|@{"o" LINK DISK}   @{"F9" LINK F1} |_________________________|@{"o" LINK DISK}|
  2673.  |      ___________________________           _________________________   |
  2674.  | @{"F5" LINK F1} |___________________________|@{"o" LINK DISK}   @{"F0" LINK F1} |_________________________|@{"o" LINK DISK}|
  2675.  |                                                                        |
  2676.  |________________________________________________________________________|
  2677. @ENDNODE
  2678. -------------------------------------------------------------------------------
  2679. @Font screenfont 8
  2680. @NODE ActivateARexx
  2681. @TITLE "Activate ARexx"
  2682.   @{b}Activate ARexx:@{ub} This  will  cause  APlayer to  open an  ARexx port  named
  2683.                   APLAYER, through which you can speak with APlayer.
  2684.                   To get more info on the APlayer ARexx commands see @{"here" LINK ARexxMain}.
  2685. @ENDNODE
  2686. -------------------------------------------------------------------------------
  2687. @NODE F1
  2688. @TITLE "ARexx Macros"
  2689.   @{b} F1-F10@{ub}: In these strings you can define  which Arexx macros to execute
  2690.            when the actual key is pressed.
  2691.            Remember that the qualifier  which is used in conjunction with
  2692.            the  key  is  set  using  the @{"cyclegadget" LINK ARexxCycle}. If your
  2693.            macros  aren't  in REXX: then you have to write the full path.
  2694.            This  can  be  done  easily  by pressing the diskgadget to the
  2695.            right of each stringgadget.
  2696.   @{i}Note: It  is not allowed  to have spaces in filenames or paths. This is
  2697.         due to an "error" in Arexx, not in APlayer.@{ui}
  2698. @ENDNODE
  2699. -------------------------------------------------------------------------------
  2700. @NODE ARexxCycle
  2701. @TITLE "ARexx Qualifier"
  2702.   @{b} Cycle@{ub}: With this you select 3 different states:
  2703.         @{b}Shift or Alt@{ub}: This position contains the names of the macros  to
  2704.                       be  executed   when  you  have  shift/alt  pressed
  2705.                       together with @{"F1-F10" LINK F1}.
  2706.        
  2707.         @{b}Other@{ub}: Changes the names of the strings to the following:
  2708.                @{b}ST@{ub}: (STart) The macro to be  executed when APlayer starts.
  2709.                    Note this is the last thing which is done when APlayer
  2710.                    starts.
  2711.                @{b}ED@{ub}: (EnD) This macro will be executed when you try to quit
  2712.                    APlayer. Note that the only way APlayer can exit then,
  2713.                    is by sending a "quit" commando to the Arexx port.
  2714.                @{b}PB@{ub}: (PlayButton) This macro is executed when you press the
  2715.                    playbutton. Note that it'll  prevent the filerequester
  2716.                    from  appearing, which enables  you  to make  your own
  2717.                    moduleselector via Arexx.
  2718.                @{b}PL@{ub}: (PLay) This  macro is  executed when a module has been
  2719.                    successfully recognized and loaded.
  2720. @ENDNODE
  2721. -------------------------------------------------------------------------------
  2722. @NODE ARexxClear
  2723.   @{b}Clear@{ub}: This will clear all macro settings. Note that it will ask you to
  2724.          confirm your choice first.
  2725. @ENDNODE
  2726. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2727. @Font topaz.font 8
  2728. @NODE cfgwindowsscreens
  2729. @TITLE "Configuration - Windows/Screens"
  2730.   ________________________________________________________________________
  2731.  |                     @{"Screens" LINK Screens}                                           |
  2732. | @{"  " LINK defaultscreen} Default Screen       |
  2733.  ||                                            |                          |
  2734.  ||                                            | @{"Save Window Positions" LINK savewindowpositions}   |
  2735.  ||                                            |                          |
  2736.  ||                                            |                          |
  2737.  ||                                            |                          |
  2738.  ||                                            |                          |
  2739.  ||____________________________________________|                          |
  2740.  |________________________________________________________________________|
  2741.  |                     _______________________________________            |
  2742.  |         @{"List Font" LINK listfont} |@{u}topaz.8@{uu}________________________________| @{"o" LINK DISK}        |
  2743.  |                     _______________________________________            |
  2744.  |      @{"General Font" LINK generalfont} |topaz.8                                | @{"o" LINK DISK} 1/1 < >|
  2745.  |                     
  2746.             |
  2747. @ENDNODE
  2748. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2749. @Font screenfont 8
  2750. @NODE Screens
  2751. @TITLE "Screen List"
  2752.   @{b}Screen List:@{ub}
  2753.   This is a list of all available public screens at the moment.  From  this
  2754.   list  you  can  choose on which screen you will like APlayer to be opened
  2755.   on. If you double click one of the screen names, APlayer  will  instantly
  2756.   jump to  that screen. The screen choice can of course still  be cancelled
  2757.   with the configuration @{"cancel" LINK cfgsaveusecancel} button.
  2758. @ENDNODE
  2759. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2760. @NODE Defaultscreen
  2761. @TITLE "Default Screen"
  2762.  @{b}Default Screen@{ub}
  2763.  Setting this flag will cause APlayer always to open on the default  public
  2764.  screen, instead of the one chosen from the @{"Screens" LINK screens} list.
  2765. @ENDNODE
  2766. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2767. @NODE Savewindowpositions
  2768. @TITLE "Save Window Positions"
  2769.   @{b}Save Window Positions:@{ub}
  2770.   To use this button do the following:
  2771.   1. Place all  the APlayer  windows exactly where  you want  them and size
  2772.      them  as you  like. You can close  a window when you  have placed  and
  2773.      sized it since the position and size will be remembered anyway.
  2774.   2. Press this button
  2775.   3. All window  positions and  sizes will now be  saved  in a  file called
  2776.      APlayer.win
  2777.   @{b}NOTE 1:@{ub} This is a kind snapshot function,  and  if  you  don't  like  the
  2778.   snapshot,  and you don't want to change the window positions, you have to
  2779.   manually delete the APlayer.win file from the ENVARC:APlayer/ directory.
  2780.   @{b}Note 2:@{ub} If you try to open a window with coordinates which  are  too  big
  2781.   for the actual screen, then the windowposition and size will be fitted to
  2782.   the screen if possible, else it will not be opened.
  2783. @ENDNODE
  2784. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2785. @NODE Listfont
  2786. @TITLE "List Font"
  2787.   @{b}List Font:@{ub}
  2788.   The font defined here will appear in all APlayer lists. The font can have
  2789.   a max size of 24.
  2790. @ENDNODE
  2791. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2792. @NODE GeneralFont
  2793. @TITLE "General Font"
  2794.   @{b}General Font:@{ub}
  2795.   The general  font is used in all gadgets, strings, yes nearly everywhere,
  2796.   except @{"lists" LINK listfont}.
  2797.   @{b}NOTE:@{ub} Since APlayers front-end isn't font sensitive, it is not adviseable
  2798.   to choose a font bigger  than 8 points, if you still want APlayer to look
  2799.   good :)
  2800. @ENDNODE
  2801. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2802. @Font topaz.font 8
  2803. @NODE cfgunpack
  2804. @TITLE "Configuration - Unpack"
  2805.   ________________________________________________________________________
  2806.  |                                                                        |
  2807.  |              @{"Path" LINK Unpackpath}             @{"Arguments" LINK Unpackarguments}          @{"Check Pattern" LINK checkpattern}      |
  2808.  |     _______________________  _______________   _______________________ |
  2809.  | @{"  " LINK unpacklha}|LHA                    ||e "%s"         | |(#?.lha|#?.lzh)        ||
  2810.  |     
  2811.  |     _______________________  _______________   _______________________ |
  2812.  | @{"  " LINK unpacklzx}|LZX                    ||x "%s"         | |#?.lzx                 ||
  2813.  |     
  2814.  |________________________________________________________________________|
  2815.  |                        ______________________________________________  |
  2816.  |      @{"Extract Pattern" LINK extractpattern}:|@{u}#?@{uu}____________________________________________| |
  2817.  |________________________________________________________________________|
  2818.  |                       _______________________________________          |
  2819.  |      @{"Unpack Library" LINK unpacklibrary}: @|                None                 | 1/1 < > |
  2820.  |                       
  2821.           |
  2822. @ENDNODE
  2823. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2824. @Font screenfont 8
  2825. @NODE Unpackpath
  2826. @TITLE "Unpack Path"
  2827.   @{b}Unpack Path:@{ub}
  2828.   Here you tell APlayer where you have your lha extractor. Per default both
  2829.   lha  and  lzx  should  be in the path, so if you for instance have lha as
  2830.   dh0:archivers/lha you should write in the lha path field.
  2831. @ENDNODE
  2832. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2833. @NODE Unpackarguments
  2834. @TITLE "Unpack Arguments"
  2835.   @{b}Unpack Arguments:@{ub}
  2836.   This is the arguments which APlayer passes on to the archiver. Most users
  2837.   won't  have  to  alter  these  arguments,  but perhaps you have a special
  2838.   unarchiver which needs special arguments then you can write them here.
  2839. @ENDNODE
  2840. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2841. @NODE checkpattern
  2842. @TITLE "Unpack Check Pattern"
  2843.   @{b}Check Pattern:@{ub}
  2844.   Here you can tell APlayer how it should recognize archives. Archives will
  2845.   only  be  recognized by their filename, so you can type a filepattern for
  2846.   every archiver here.
  2847.   For instance the default lha checkpattern is (#?.lha|#?.lzh) which  means
  2848.   that every file ending with either ".lha" or ".lzh" will be recognized as
  2849.   a lha archive.
  2850. @ENDNODE
  2851. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2852. @NODE unpacklha
  2853. @TITLE "Unpack Lha"
  2854.   @{b}Unpack Lha@{ub}
  2855.   This simply tells APlayer wether to check files to see if  they  are  lha
  2856.   archives or not.
  2857. @ENDNODE
  2858. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2859. @NODE unpacklzx
  2860. @TITLE "Unpack Lzx"
  2861.   @{b}Unpack Lzx@{ub}
  2862.   This simply tells APlayer wether to check files to see if  they  are  lzx
  2863.   archives or not.
  2864. @ENDNODE
  2865. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2866. @NODE extractpattern
  2867. @TITLE "Extract Pattern"
  2868.   @{b}Extract Pattern:@{ub}
  2869.   Suppose you have a lot  of  lha  and  lzx  archives  with  both  modules,
  2870.   pictures  and  texts  (file_id.diz, .nfo-files and others). Since APlayer
  2871.   will not recognize anything else than music modules, why should  all  the
  2872.   other files get unarchived, wasting your sparesome cpu-time :)
  2873.   Therefore you can use the extract pattern to  tell  APlayer  which  files
  2874.   should be unarchived, and which shouldn't.
  2875.   If you want to get rid of certain files, you can for instance write  this
  2876.   as an extract pattern: ~(file_id.diz|#?.doc|#?.nfo|#?.txt|#?.gif)
  2877. @ENDNODE
  2878. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2879. @NODE unpacklibrary
  2880. @TITLE "Unpack Library"
  2881.   @{u}@{b}Unpack Library:@{ub}@{uu}
  2882.   This cyclegadget is used to select which library  you  want  to  use  for
  2883.   unpacking your modules. There are four possibilities:
  2884.   @{b}1. None       :@{ub} If   you  do  not  have  any  packed  modules,  use  this
  2885.                   selection.
  2886.   @{b}3. XPK        :@{ub} This  will  make  use of the @{"xpk-libraries" LINK Thanks} for depacking
  2887.                   your  modules. This means that it can unpack all kinds of
  2888.                   xpk-packed files including powerpacked files. Included in
  2889.                   this package is SQSH-, SMPL- and Xpkmaster-.library.
  2890.   @{b}4. Unpack     :@{ub} This  is  a  library  made  by the coder of this program,
  2891.                   which   can  recognize  and  decrunch  approximately  180
  2892.                   different  types  of  crunchers.  This  includes xpk, and
  2893.                   powerpacker.
  2894. @ENDNODE
  2895. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2896. -------------------------------------------------------------------------------
  2897. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2898. <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
  2899. @NODE cfgPages
  2900. @TITLE "Sub pages"
  2901.   @{b}@{u}Sub Configuration Pages:@{uu}@{ub}
  2902.   Some of the main configuration pages uses more than  one  page.  To  look
  2903.   through the different sub-pages you can use these two arrows.
  2904.   The x/x tells the number of the actual sub-page and the total  amount  of
  2905.   sub-pages.
  2906. @ENDNODE
  2907. -------------------------------------------------------------------------------
  2908. @NODE prefsmenu
  2909. @TITLE "Preference Menu"
  2910.   @{u}@{b}Preference Menu:@{uu}@{ub}
  2911.   @{b}Project:@{ub}
  2912.    Open   : Opens a file  requester from which you  can load a new  config
  2913.             file.
  2914.    Save as: Opens  a file requester  from which you  can save  your actual
  2915.             settings.
  2916.    Quit   : This is the same as pressing cancel.
  2917.   @{b}Edit:@{ub}
  2918.    Reset To Default: This will reset the settings to the default values.
  2919.    Last Saved      : Sets your  configuration  settings to the settings of
  2920.                      the last saved configuration file.
  2921.    Restore         : The same as "Cancel", except that  it won't close the
  2922.                      window.
  2923. @ENDNODE
  2924. -------------------------------------------------------------------------------
  2925. @NODE listview
  2926. @TITLE "ListView Control"
  2927.   @{b}@{u}Listview Control:@{ub}@{uu}
  2928.   @{b}Arrow up@{ub} or @{b}down@{ub}  will move  the  highlightbar  one position up  or down.
  2929.   If no element in the list is highlighted the highlightbar will appear  at
  2930.   any cursor press.
  2931.   Using @{b}Shift@{ub} with the cursor keys, will move the list either one "page" up
  2932.   or one page down.
  2933.   Using  @{b}control@{ub} or @{b}alt@{ub} with the cursor keys  will move the highlightbar to
  2934.   either the top or the bottom.
  2935.   @{b}Return@{ub} will toggle the current (Note)player's state (enabled/disabled).
  2936. @ENDNODE
  2937. -------------------------------------------------------------------------------
  2938. @NODE DISK
  2939. @TITLE "File Requester"
  2940.  This disk button will open a @{"reqtools" LINK thanks} file requester.
  2941. @ENDNODE
  2942. -------------------------------------------------------------------------------
  2943. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2944. @Font topaz.font 8
  2945. @NODE cfgplayers
  2946. @TITLE "Players/Noteplayers/Agents Configuration"
  2947.   @{b}@{u}Players/Noteplayers/Agents Configuration:@{ub}@{uu}
  2948.   ________________________________________________________________________
  2949.  | @{"*|            Players          " LINK plcyc} ||@{"3.13" LINK plcfgversion}  Surround-32Voices          @{"?" LINK plcfgquestionmark}|
  2950.  |                                  ||                                    |
  2951.  |                                  ||   This box contains some info      |
  2952.  |                                  ||                                    |
  2953.  |                                  ||   about the chosen player.         |
  2954.  |          @{"Player List" LINK plcfgplayerlist}            ||                                    |
  2955.  |                                  ||   Like author, technical info      |
  2956.  |                                  ||                                    |
  2957.  |                                  ||   and if it supports noteplayers.  |
  2958.  |                                  ||                                    |
  2959.  |                                  ||                                    |
  2960.  | @{" v ^ " LINK plcfgArrowupdown} @{" Config " LINK plcfgConfig} @{" Show " LINK plcfgShow} @{" Add " LINK plcfgAdd} @{" Delete " LINK plcfgDelete} @{" Exchange " LINK plcfgExchange} @{" Clear " LINK plcfgClear} @{" Sort " LINK plcfgSort} |
  2961.  |________________________________________________________________________|
  2962.  |                                                                        |
  2963.  | @{" Save " LINK plcfgsave}                        @{" Use " LINK plcfguse}                        @{" Cancel " LINK plcfgcancel} |
  2964.  |________________________________________________________________________|
  2965.   APlayer supports a lot of different module types from the SID  format  to
  2966.   Protracker. These  modules  are  played by  using  player  libraries  and
  2967.   sometimes also a noteplayer.
  2968.   Click @{"here" LINK prefsmenu} to see how to use the menus in this window.
  2969.   To move around the list you can use the @{"keyboard" LINK listview}.
  2970. @ENDNODE
  2971. <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
  2972. -------------------------------------------------------------------------------
  2973. @Font screenfont 8
  2974. @NODE plcfgplayerlist
  2975. @TITLE "Player/Noteplayer/Agent List"
  2976.   This list shows all available players, noteplayers and agents. To add new
  2977.   items use the add button.
  2978.   To toggle an entry in the list, you can just double-click the entry. This
  2979.   will prevent the use of the specific entry.
  2980. @ENDNODE
  2981. -------------------------------------------------------------------------------
  2982. @NODE plcfgversion
  2983. @TITLE "Version"
  2984.   Shows the version number of the chosen player, noteplayer or agent.
  2985. @ENDNODE
  2986. -------------------------------------------------------------------------------
  2987. @NODE plcfgquestionmark
  2988. @TITLE "1st Priority Noteplayer"
  2989.   This opens a list, from which you can choose the NotePlayer you prefer to
  2990.   be used with the selected player.  If you don't want  any first priority,
  2991.   just delete the name manually afterwards (you may use Amiga-X).
  2992.   If, at a later time, the selected NotePlayer  can't  be  loaded,  APlayer
  2993.   will  give  you  a requester where you can choose to stop or make APlayer
  2994.   choose a Noteplayer for you.
  2995. @ENDNODE
  2996. -------------------------------------------------------------------------------
  2997. @NODE plcfgArrowupdown
  2998. @TITLE "Item Up/Down"
  2999.   @{b}Arrow up/down:@{ub} These will move the  marked item to  either  the  position
  3000.                  above or below.
  3001.                  Pressing @{b}shift@{ub} in  conjunction  with the gadget, will move
  3002.                  the selected item to the top or the bottom of the list.
  3003. @ENDNODE
  3004. -------------------------------------------------------------------------------
  3005. @NODE plcfgConfig
  3006. @TITLE "Config"
  3007.   @{b}Config:@{ub}   Opens  a window  in which  special settings  for  the  selected
  3008.             player may be changed.
  3009. @ENDNODE
  3010. -------------------------------------------------------------------------------
  3011. @NODE plcfgShow
  3012. @TITLE "Show"
  3013.   @{b}Show:@{ub}     Will open the show window of the given Agent/Player/Noteplayer.
  3014. @ENDNODE
  3015. -------------------------------------------------------------------------------
  3016. @NODE plcfgAdd
  3017. @TITLE "Add Item"
  3018.   @{b}Add:@{ub}      Opens  a  filerequester from which you can choose the libraries
  3019.             (Agents/Players/Noteplayers) you want to add to the list.
  3020. @ENDNODE
  3021. -------------------------------------------------------------------------------
  3022. @NODE plcfgDelete
  3023. @TITLE "Delete Item"
  3024.   @{b}Delete:@{ub}   This  will  delete  the selected library from the list, but NOT
  3025.             from the disk.
  3026. @ENDNODE
  3027. -------------------------------------------------------------------------------
  3028. @NODE plcfgExchange
  3029. @TITLE "Exchange Items"
  3030.   @{b}Exchange:@{ub} Select a library, press exchange and  select another library to
  3031.             exchange the first library with.
  3032. @ENDNODE
  3033. -------------------------------------------------------------------------------
  3034. @NODE plcfgClear
  3035. @TITLE "Clear List"
  3036.   @{b}Clear:@{ub}    This will clear all the libraries except for the internals.
  3037. @ENDNODE
  3038. -------------------------------------------------------------------------------
  3039. @NODE plcfgSort
  3040. @TITLE "Sort Items"
  3041.   @{b}Sort:@{ub}     Sorts the list alphabetically.
  3042. @ENDNODE
  3043. -------------------------------------------------------------------------------
  3044. @NODE plcfgSave
  3045. @TITLE "Save Player/Noteplayer/Agent Configuration"
  3046.   @{b}Save:@{ub}     Saves   the  APlayer.libs  file   in  ENVARC:APlayer/   and  in
  3047.             ENV:APlayer/ directories. After the saving it closes the window
  3048.             and  uses  the  settings.  If  the  actual player/noteplayer is
  3049.             deleted  from  the  list and you press save, the playing module
  3050.             will be ejected.
  3051. @ENDNODE
  3052. -------------------------------------------------------------------------------
  3053. @NODE plcfgUse
  3054. @TITLE "Use Player/Noteplayer/Agent Configuration"
  3055.   @{b}Use:@{ub}      Saves the  APlayer.libs  file  in  the  ENV:APlayer/ directory.
  3056.             After the saving it closes the window and uses the settings. If
  3057.             the  current player/noteplayer is deleted from the list and you
  3058.             press use, the playing module will be ejected.
  3059. @ENDNODE
  3060. -------------------------------------------------------------------------------
  3061. @NODE plcfgCancel
  3062. @TITLE "Cancel Player/Noteplayer/Agent Configuration"
  3063.   @{b}Cancel:@{ub}   Closes the window and restores the settings.
  3064. @ENDNODE
  3065. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  3066. @NODE plcyc
  3067. @TITLE "List Selector"
  3068.   @{b}@{u}List Selector:@{uu}@{ub}
  3069.   @{"Players" LINK Players}     A player recognizes  and plays the  module. Some  feeds  the
  3070.                hardware directly, some passes the data to a noteplayer.
  3071.                When a player is selected (and if it uses a noteplayer), you
  3072.                can  press  the  "?"  button in the top right of the window.
  3073.                This  will  open  a  window  with  a list containing all the
  3074.                NotePlayers  which can be used by the player. Hereby you can
  3075.                select  the  NotePlayer  you  prefer should be used with the
  3076.                player.  If, for some reason, the NotePlayer isn't available
  3077.                when  the  player  tries to use it, it will scan through the
  3078.                NotePlayers until it finds a usable one.
  3079.   @{"NotePlayers" LINK NotePlayers} The noteplayer  recieves the sound data from  the player and
  3080.                makes your computer play the sound. Some of the  noteplayers
  3081.                has  the ability to mix several channels into the four audio
  3082.                channels of the amiga.
  3083.   @{"Agents" LINK Agents}      Agents are programs which can be  initiated  when  the  user
  3084.                performs a certain action.
  3085.   You can cycle trough the items with the keys < and >.
  3086.   Some (Note)Players are built  into the  main program  while  the rest  of
  3087.   them are stored as files in "LIBS:APlayer" or "LIBS:APlayer/NotePlayers".
  3088.   When APlayer has loaded a file, it has to  check which type of module  it
  3089.   is. With  this  window  you can decide which (Note)Players that should be
  3090.   used, and in which order they should be used (prioritized list).
  3091.   When  a (Note)Player  is chosen, the  version number  is displayed  in  a
  3092.   little box in the top left of the right part of the window.
  3093. @ENDNODE
  3094. --------------------------------------------------------------------------------
  3095. @NODE players
  3096. @TITLE "Players"
  3097.   @{b}See the bottom of this page to see which players that has been removed
  3098.   as of version 2.11 of APlayer.@{ub}
  3099.   @{b}@{u}Players:@{ub}@{uu}
  3100.   @{b}Activision Pro:@{ub}  This player is the same as Martin Walker player. You can
  3101.                    get some modules from old Activision games. There can be
  3102.                    some  trouble  on  faster  machines,  because the player
  3103.                    makes  CPU  loops.  The  player is inside the module, so
  3104.                    there isn't much to do about it.
  3105. ---------------------------------------------------------------------------
  3106.   @{b}ArtOfNoise:@{ub}      This player can play both 4 and 8 channels  modules.  It
  3107.                    have  some  great effect. It uses noteplayer to play the
  3108.                    modules.
  3109. ---------------------------------------------------------------------------
  3110.   @{b}Ben Daglish:@{ub}     The player is placed inside the modules,  so don't blame
  3111.                    us  for  crashing computers.  Some fixes will be made in
  3112.                    the player, so it will work better on all 680x0 CPUs.
  3113. ---------------------------------------------------------------------------
  3114.   @{b}DeliCustom:@{ub}      Yes,  that's  right.  Now  is  APlayer  able   to   play
  3115.                    Delitrackers  custom  modules.  Currently  there  is not
  3116.                    support  of  all  Delitrackers global functions or tags,
  3117.                    only  a  few. The modules I have, work just fine, but if
  3118.                    you  have  a module that doesn't work, please send it to
  3119.                    me.  You  can not pack these modules, because the player
  3120.                    has to load them as object files.
  3121. ---------------------------------------------------------------------------
  3122.   @{b}Delta10:@{ub}         The  older Delta  modules is  played with  this.  And it
  3123.                    supports noteplayers.
  3124. ---------------------------------------------------------------------------
  3125.   @{b}Delta20:@{ub}         Player is inside the module.  It  have  some  nice sound
  3126.                    effect.
  3127. ---------------------------------------------------------------------------
  3128.   @{b}DigiBooster:@{ub}     Plays modules from the new protracker clone DigiBooster.
  3129.                    This includes both 4/8 channels and cia timing. It plays
  3130.                    modules from DigiBooster 1.0 - 1.5
  3131. ---------------------------------------------------------------------------
  3132.   @{b}DigitalMugician:@{ub} Nice player with some cool sound effects. The program is
  3133.                    not the most system friendly I have seen.
  3134. ---------------------------------------------------------------------------
  3135.   @{b}DSS:@{ub}             When you buy the DSS sampler, you will get a  music  and
  3136.                    sampler  program. The music program will save modules in
  3137.                    this  format,  so  with this player you are able to play
  3138.                    these type of modules.
  3139. ---------------------------------------------------------------------------
  3140.   @{b}FastTracker:@{ub}     I don't  know much  about this  player.  It's a 6 and  8
  3141.                    channels  ProTracker player. It  can do the  same as the
  3142.                    ProTracker  player, which  means  that it  has the  same
  3143.                    commands  etc.  It  also  incorporates  the  Taketracker
  3144.                    player. This player uses a NotePlayer.
  3145. ---------------------------------------------------------------------------
  3146.   @{b}FastTracker20:@{ub}   This player can play the new format on the PC,  the *.XM
  3147.                    modules. The original music program on the PC is made by
  3148.                    Triton.  This  player  is coded by Jarno Paananen and it
  3149.                    uses a NotePlayer.
  3150. ---------------------------------------------------------------------------
  3151.   @{b}Fred:@{ub}            There is a lot of some nice fred tunes on  aminet,  some
  3152.                    of them by Jogeir. There is a player inside the modules,
  3153.                    but  I  have ripped one of them and added some features.
  3154.                    It  will  ofcourse  use  the player inside the module if
  3155.                    it's not the same as the one I know. Currently I support
  3156.                    2 different players, which only differs slightly.
  3157. ---------------------------------------------------------------------------
  3158.   @{b}Future13:@{ub}        This  is  probably  the  most  used  type  of modules in
  3159.                    intros,  because  of  the  short  module size. It uses a
  3160.                    noteplayer.
  3161. ---------------------------------------------------------------------------
  3162.   @{b}Future14:@{ub}        This is the newer version of Future Composer. It can now
  3163.                    handle different wavetables. It uses a noteplayer.
  3164. ---------------------------------------------------------------------------
  3165.   @{b}Hippel:@{ub}          Argghh, this is one of the hard ones.  There is a player
  3166.                    inside each module, but they are all different.
  3167.                    If you  get a Hippel  module this player can't recognize
  3168.                    please mail it  to us if you want  APlayer to be able to
  3169.                    play it in the future..
  3170. ---------------------------------------------------------------------------
  3171.   @{b}IFF-8SVX:@{ub}        This player can  play the IFF-8SVX  sample format. It is
  3172.                    the  most used format on the Amiga. It can play any size
  3173.                    of  samples  by  loading  a little bit at the time. This
  3174.                    means  it  uses  low  memory  while running. It can also
  3175.                    handle   stereo  samples  and  IFF-crunched  (Fibonnaci)
  3176.                    samples, in both mono and stereo. It uses a noteplayer.
  3177.                    See how to @{"configure" LINK iffcfg} this player.
  3178. ---------------------------------------------------------------------------
  3179.   @{b}IFF-AIFF:@{ub}        This format is used on  the  Macintosh.  This player can
  3180.                    play  both 8 and 16 bit samples in both mono and stereo.
  3181.                    16 bit samples will be converted to 8 bit realtime while
  3182.                    playing. It uses a noteplayer.
  3183.                    See how to @{"configure" LINK aiffcfg} this player.
  3184. ---------------------------------------------------------------------------
  3185.   @{b}IFF-SMUS:@{ub}        This is a very old music format.  The format is designed
  3186.                    to  use with midi. This player will only play upto the 4
  3187.                    first priority voices.
  3188.                    See how to @{"configure" LINK smuscfg} this player.
  3189. ---------------------------------------------------------------------------
  3190.   @{b}ImpulseTracker:@{ub}  A pretty popular  PC tracker right  now.  The  player is
  3191.                    coded  in pure C (C++) - jiipie! :)  The format  has  64
  3192.                    channels, but only 32 channels will be played.  Ofcourse
  3193.                    the player uses noteplayers.
  3194. ---------------------------------------------------------------------------
  3195.   @{b}InStereo20:@{ub}      Plays the newer InStereo2.0 modules using noteplayers.
  3196. ---------------------------------------------------------------------------
  3197.   @{b}JamCracker:@{ub}      Is not the most used format,  but  there  is  some  nice
  3198.                    tunes   available   made  by  Dr.  Awesome.  It  uses  a
  3199.                    noteplayer.
  3200. ---------------------------------------------------------------------------
  3201.   @{b}JCBrooke:@{ub}        Nothing to say about this player.
  3202. ---------------------------------------------------------------------------
  3203.   @{b}MarkCooksey:@{ub}     Nothing to say about this player.
  3204. ---------------------------------------------------------------------------
  3205.   @{b}MarkII:@{ub}          Nothing to say about  this player, except that the  main
  3206.                    replay routine is placed in each module.
  3207. ---------------------------------------------------------------------------
  3208.   @{b}MED:@{ub}             This player has one of the biggest  sources I  have ever
  3209.                    seen  (about  80Kb).  This player will play 4 voices MED
  3210.                    modules and can handle MMD0, MMD1 and MMD2 module types.
  3211.                    Please note  that  if  you  want  to  play  MED  modules
  3212.                    containing   synth  samples,  do  NOT  use  the  fastmem
  3213.                    noteplayer, since it will skip  all  synth  sounds.  Use
  3214.                    instead the paula noteplayer.
  3215.                    This Player uses a Noteplayer.
  3216. ---------------------------------------------------------------------------
  3217.   @{b}MON:@{ub}             Maniacs of Noise have created this player. The player is
  3218.                    inside the modules.
  3219. ---------------------------------------------------------------------------
  3220.   @{b}MultiTracker:@{ub}    This tracker is  a 1-32 channels  ProTracker player. The
  3221.                    file format is not the same as in normal mod files. This
  3222.                    player uses a NotePlayer.
  3223. ---------------------------------------------------------------------------
  3224.   @{b}MusicAss:@{ub}        This format has  very  short  modules  with  the  player
  3225.                    inside  the  modules.  It will  of course  only use  the
  3226.                    player inside  the module  if it is not  the same as the
  3227.                    ripped one. Now it uses noteplayers.
  3228. ---------------------------------------------------------------------------
  3229.   @{b}MusicLine:@{ub}       A very cool music-program which sports many realtime
  3230.                    effects. APlayer uses the mline.library, which is included,
  3231.                    to play the modules.
  3232. ---------------------------------------------------------------------------
  3233.   @{b}NoisePacker20:@{ub}   This format is a packed NoiseTracker format  written  by
  3234.                    Twins of Phenomena.
  3235. ---------------------------------------------------------------------------
  3236.   @{b}NoisePacker30:@{ub}   Is a newer version of the NoiseTracker packer.
  3237. ---------------------------------------------------------------------------
  3238.   @{b}NoiseTracker:@{ub}    Before ProTracker this format was  the most used.  I use
  3239.                    the  same  player  as  in  the ProTracker player, but it
  3240.                    can't  change  the  CIA  tempo and it doesn't have any E
  3241.                    commands   except   for  the  filter  command.  See  the
  3242.                    ProTracker description for more information. This player
  3243.                    uses a NotePlayer.
  3244. ---------------------------------------------------------------------------
  3245.   @{b}OctaMed:@{ub}         This player is almost the same as the MED player, except
  3246.                    that it play 5-8 voices modules.
  3247.                    This player uses a Noteplayer.
  3248. ---------------------------------------------------------------------------
  3249.   @{b}OctaMedSS:@{ub}       This supports all the features of the fabolous
  3250.                    OctaMED Sound Studio. @{"Configuration" LINK ocsscfg}
  3251. ---------------------------------------------------------------------------
  3252.   @{b}Oktalyzer:@{ub}       A very old 8 voices format. It now uses a NotePlayer  to
  3253.                    mix the channels. This player uses a Noteplayer.
  3254. ---------------------------------------------------------------------------
  3255.   @{b}ProTracker:@{ub}      This format is probably  the most  known  format ever on
  3256.                    the  Amiga.  I  use  the  ProTracker version 1.1b player
  3257.                    written  by  Lars  "Zap" Hamre/Amiga Freelancers. I have
  3258.                    fixed  a lot of bugs (see the history :) and I have also
  3259.                    optimized  it  so  it  won't use so much CPU time as the
  3260.                    original player does. The  main  optimizing is that I've
  3261.                    changed all  the patterns  note periods to index numbers
  3262.                    in the  period  tables.  This removed  the routine which
  3263.                    searched  for the period in the period tables to get the
  3264.                    index  in  the finetunes period tables. This player uses
  3265.                    a NotePlayer to play the notes.
  3266. ---------------------------------------------------------------------------
  3267.   @{b}PumaTracker:@{ub}     I don't know anything about this player.  I  only have a
  3268.                    few modules of this type.
  3269. ---------------------------------------------------------------------------
  3270.   @{b}QuadraComposer:@{ub}  Got the player from the author, Bo Lincoln. Supports CIA
  3271.                    and all commands without crashing like in other players.
  3272.                    It also uses a noteplayer.
  3273. ---------------------------------------------------------------------------
  3274.   @{b}RIFF-WAVE:@{ub}       This format is used on the PC. It can play both 8 and 16
  3275.                    bit samples in mono or stereo. If the sample is too big,
  3276.                    it will be loaded in parts.
  3277.                    This player uses a Noteplayer.
  3278.                    See how to @{"configure" LINK riffcfg} this player.
  3279. ---------------------------------------------------------------------------
  3280.   @{b}RonKlaren:@{ub}       This player will play EaglePlayer  Ron  Klaren  modules.
  3281.                    This is the only type of module which cannot be crunched
  3282.                    because the files are loaded as object files.
  3283.                    There can be some problems on A4000.
  3284. ---------------------------------------------------------------------------
  3285.   @{b}ScreamTracker30:@{ub} This module format is probably one of the most  used  on
  3286.                    the  PC.  This  player  will  play  that  format.  Jarno
  3287.                    Paananen has coded the original player.  I have modified
  3288.                    it a little bit,  so it won't try  to play adlib samples
  3289.                    There  will  be  silence  instead of some crap sound. It
  3290.                    also uses a noteplayer.
  3291. ---------------------------------------------------------------------------
  3292.   @{b}SID:@{ub}             This play has to use the playsid.library to run.  It can
  3293.                    play all kinds of C64 songs by emulating the CPU and SID
  3294.                    in the C64.
  3295.                    See how to @{"configure" LINK sidcfg} this player.
  3296. ---------------------------------------------------------------------------
  3297.   @{b}SidMon10:@{ub}        Player is inside the module. I have  ripped  the  player
  3298.                    and  added  a few features. If the player isn't the same
  3299.                    as  the player inside the module, the inside player will
  3300.                    be used instead.
  3301. ---------------------------------------------------------------------------
  3302.   @{b}SidMon20:@{ub}        This is the new version of SidMon.  It hasn't the player
  3303.                    inside the module anymore, and it uses Noteplayers.
  3304. ---------------------------------------------------------------------------
  3305.   @{b}SoundFactory:@{ub}    This player uses a Noteplayer.
  3306. ---------------------------------------------------------------------------
  3307.   @{b}SoundFX13:@{ub}       This player looks a lot like the SoundTracker player.
  3308.                    And it supports noteplayers.
  3309. ---------------------------------------------------------------------------
  3310.   @{b}SoundFX20:@{ub}       A new  version  of  this  program.  It  now  supports 31
  3311.                    samples!! (whauww ;-) This also uses Noteplayer.
  3312. ---------------------------------------------------------------------------
  3313.   @{b}SoundMon20:@{ub}      You can grab a lot of these (cool) modules on aminet.
  3314.                    This player uses a Noteplayer.
  3315. ---------------------------------------------------------------------------
  3316.   @{b}SoundTracker15:@{ub}  In this very OLD tracker only 15  samples  were allowed.
  3317.                    I  use  the  same  player  as in the ProTracker  player,
  3318.                    but it only supports the SoundTracker commands.
  3319.                    See  the  ProTracker  description  for more information.
  3320.                    This player uses a NotePlayer.
  3321. ---------------------------------------------------------------------------
  3322.   @{b}SoundTracker31:@{ub}  This is also a very OLD tracker but  it has 31  samples.
  3323.                    As  always  I  use  the same player as in the ProTracker
  3324.                    player.  See that description for more information. This
  3325.                    player uses a NotePlayer.
  3326. ---------------------------------------------------------------------------
  3327.   @{b}StarTrekker4:@{ub}    This player will play the normal  4  voices  StarTrekker
  3328.                    modules.
  3329. ---------------------------------------------------------------------------
  3330.   @{b}StarTrekker4AM:@{ub}  This player will play 4 voices StarTrekker modules  with
  3331.                    AM sounds. It needs the extra .nt file to the module.
  3332. ---------------------------------------------------------------------------
  3333.   @{b}Syntracker:@{ub}      Plays Syntracker  modules.  Includes support  for nearly
  3334.                    all functions in APlayer, including Noteplayer support.
  3335. ---------------------------------------------------------------------------
  3336.   @{b}TFMX_15:@{ub}         This player can play the old TFMX formats. It's a format
  3337.                    created by Chris H
  3338. lsbeck.
  3339. ---------------------------------------------------------------------------
  3340.   @{b}THX:@{ub}             A new module format, which sports small modules sounding
  3341.                    MUCH like the C64 tunes. The average tune length is 1 Kb
  3342. ---------------------------------------------------------------------------
  3343.   @{b}TronicTracker:@{ub}   Nothing to say about this player.
  3344. ---------------------------------------------------------------------------
  3345.   @{b}Whittaker:@{ub}       Player inside the module. The players are different from
  3346.                    each other, so you can get some problems.
  3347. *-------------------------------------------------------------------------*
  3348.   @{b}These players have been removed from the APlayer distribution set as
  3349.   of version 2.11 of APlayer:@{ub}
  3350.   ActionAmics
  3351.   FTM
  3352.   Hippel-COSO
  3353.   Hippel-7V
  3354.   InStereo!
  3355.   MajorTom
  3356.   SonicArranger
  3357.   SoundControl
  3358.   SoundMon22
  3359.   Synthesis
  3360.   TFMX
  3361.   TimFolin
  3362.   TME
  3363.   VectorDean
  3364.   VSS
  3365. @ENDNODE
  3366. --------------------------------------------------------------------------------
  3367. @NODE NotePlayers
  3368. @TITLE "NotePlayers"
  3369.   @{b}@{u}NotePlayers:@{uu}@{ub}
  3370.   @{b}14BitStereo-32Voices:@{ub}   Can mix upto 32 voices, into the four amiga sound
  3371.                           channels. The samples can be 8 bit and placed  in
  3372.                           both chip- and fast-mem. The mixing routine is 16
  3373.                           bit. If the mixing routine runs out of cpu  time,
  3374.                           the sample rate is lowered.
  3375.                           The main routine  is  based  on  Jarno  Paananens
  3376.                           routines, with some fixes and additions by me.
  3377.                           See the @{"32 Voices configuration" LINK 32config} for more info.
  3378. ---------------------------------------------------------------------------
  3379.   @{b}14BitStereo-2Voices:@{ub}    This Noteplayer can mix  upto 2 channels in 14bit
  3380.                           stereo, and it is therefore very handy  to use to
  3381.                           play samples e.g. IFF-8SVX.
  3382.                           See  the @{"14 Bit Stereo 2Voices configuration" LINK 2config} for
  3383.                           more info.
  3384. ---------------------------------------------------------------------------
  3385.   @{b}AHI-64Voices:@{ub}           This  noteplayer  uses the  infamous AHI
  3386.                           sound system for the Amiga, made by Martin Blom.
  3387.                           It  handles up  to 64 sound  channels  at a  time
  3388.                           (if you've  got a real rough computer).
  3389.                           And it gives soundcard users  the possibility, to
  3390.                           use the cards (e.g. Toccata) for module playing.
  3391.                           @{b}Please  notice  that  you  need  the  AHI  device
  3392.                           installed, for this  noteplayer to work properly!@{ub}
  3393.                           For configuration please refer to @{"AHI config" LINK AHI-cfg}.
  3394. ---------------------------------------------------------------------------
  3395.                                                                           
  3396.   @{b}Fastmem-4Voices:@{ub}        This  play  modules  from  fastmemory. It handles
  3397.                           both signed and unsigned samples.
  3398. ---------------------------------------------------------------------------
  3399.   @{b}Mono-32Voices:@{ub}          Can mix upto 32 voices, into the four amiga sound
  3400.                           channels. The samples can be 8 bit and placed  in
  3401.                           both  chip-  and  fast-mem. The mixing routine is
  3402.                           only 8 bit.
  3403.                           Please note that the mixer always plays in  mono,
  3404.                           even  if  some  channels  are  turned off. If the
  3405.                           mixing routine runs out of cpu time,  the  sample
  3406.                           rate is lowered.
  3407.                           The main routine  is  based  on  Jarno  Paananens
  3408.                           routines, with some fixes and additions by me.
  3409.                           See the @{"32 Voices configuration" LINK 32config} for more info.
  3410. ---------------------------------------------------------------------------
  3411.   @{b}Paula-4Voices:@{ub}          Passes on the data it gets from the player to the
  3412.                           sound chip. The samples can only be placed in the
  3413.                           chip memory.
  3414. ---------------------------------------------------------------------------
  3415.   @{b}ReSurround-32Voices:@{ub}    If  you  are  the  lucky  owner  of  a  surround
  3416.                           amplifier, you can connect your Amiga to  it  and
  3417.                           use  this player to listen to the modules in REAL
  3418.                           surround :).
  3419.                           It can mix upto 32 voices, into  the  four  amiga
  3420.                           sound  channels.  The  samples  can  be 8 bit and
  3421.                           placed  in  both  chip and fast-mem.  The  mixing
  3422.                           routine is only 8 bit.
  3423.                           Please note that the mixer always plays  in  real
  3424.                           surround,  even  if some channels are turned off.
  3425.                           If the mixing routine runs out of cpu  time,  the
  3426.                           sample rate is lowered.
  3427.                           The main routine  is  based  on  Jarno  Paananens
  3428.                           routines, with some fixes and additions by me.
  3429.                           See the @{"32 Voices configuration" LINK 32config} for more info.
  3430. ---------------------------------------------------------------------------
  3431.   @{b}Stereo-32Voices:@{ub}        Can mix upto 32 voices, into the four amiga sound
  3432.                           channels. The samples can be 8 bit and placed  in
  3433.                           both  chip-  and  fast-mem. The mixing routine is
  3434.                           only 8 bit. If the mixing routine runs out of cpu
  3435.                           time, the sample rate is lowered.
  3436.                           The main routine  is  based  on  Jarno  Paananens
  3437.                           routines, with some fixes and additions by me.
  3438.                           See the @{"32 Voices configuration" LINK 32config} for more info.
  3439. ---------------------------------------------------------------------------
  3440.   @{b}Surround-32Voices:@{ub}      Can mix upto 32 voices, into the four amiga sound
  3441.                           channels. The samples can be 8 bit and placed  in
  3442.                           both  chip-  and  fast-mem. The mixing routine is
  3443.                           only 8 bit.
  3444.                           Please  note  that  the  mixer  always  plays  in
  3445.                           surround,  even  if some channels are turned off.
  3446.                           If the mixing routine runs out of cpu  time,  the
  3447.                           sample rate is lowered.
  3448.                           The main routine  is  based  on  Jarno  Paananens
  3449.                           routines, with some fixes and additions by me.
  3450.                           See the @{"32 Voices configuration" LINK 32config} for more info.
  3451. @ENDNODE
  3452. --------------------------------------------------------------------------------
  3453. @NODE 32config
  3454. @TITLE 32 Voices Configuration
  3455.   @{u}@{b}32 Voices Configuration:@{uu}@{ub}
  3456.   First of all you have to choose which mixing routine  you  want  to  use.
  3457.   This  can  either  be  the  68000/68010  or  68020+.  The 68020+ mixer is
  3458.   ofcourse optimized for higher processors.
  3459.   This configuration is used to set the mixing rate relative to the  number
  3460.   of channels used in a module. This means that the higher mixing rate, the
  3461.   better sound. But remember that high mixing rates demands more cpu power.
  3462.   As  soon as you press return, after you have typed a new mixing rate, the
  3463.   new mixing rate is used. This is ofcourse only if you  have  changed  the
  3464.   mixing rate for the current number of used channels.
  3465.   You can also set the volume boost for every number of  channels.  If  you
  3466.   are  listening  to  modules  that  uses  a  lot of channels, you can take
  3467.   advantage of volume boost. This is because if a lot of channels has to be
  3468.   mixed, the volume will be lowered,  and therefore it needs to be boosted.
  3469.   The boost value will only take effect when a new module is played.
  3470.   If you don't know which values to type in, you can get APlayer to  choose
  3471.   the values best suited for your system.  This can be done by pressing the
  3472.   autoadjust button. It CAN'T be done if APlayer is playing  a  module,  or
  3473.   the audio channels is allocated by another program.
  3474.   First, you are asked if you want to check all the channels. If you answer
  3475.   NO, only the 31-32  channel mode is tested, and the result is used in all
  3476.   other channels mode, else every channel mode is tested.
  3477.   Then you can decide the maximum mixing rate to be used.  This  can  be  a
  3478.   number between 4000 and 56000. The higher the mixing rate, the better the
  3479.   sound quality.
  3480.   The last two requesters will let you decide wether you want to adjust the
  3481.   found  mixing  rate a bit down (0-100 percent), which will leave more cpu
  3482.   power to the rest of the system.
  3483.   After this the test is performed. To optimize the results, do  NOT  touch
  3484.   your computer while the test is in progress. You can adjust the volume in
  3485.   the main window, if you don't want to hear the tones while  the  test  is
  3486.   running.
  3487.   @{b}Please note  that the numbers  found in the test  may not be the  optimal
  3488.   setting, but should give you a hint on how the setting should be.@{ub}
  3489.   Click @{"here" LINK prefsmenu} to see how to use the menus in this window.
  3490. @ENDNODE
  3491. --------------------------------------------------------------------------------
  3492. @NODE 2config
  3493. @TITLE "14 Bit Stereo 2Voices configuration"
  3494.   @{b}@{u}14 Bit Stereo 2Voices configuration:@{uu}@{ub}
  3495.   Here you can set the size of the "Chip Memory Buffer" which is the amount
  3496.   of  CHIP memory used for every channel while playing from fastmemory. The
  3497.   default is 512, which suits  most configurations,  but if  it  gives  you
  3498.   trouble, you can try to change it.
  3499.   The "Maximum Sample Rate" will cause every sample with a higher frequency
  3500.   than  the  specified,  to  be downsampled to that frequency. Normally the
  3501.   amiga hardware will not allow you to play samples with a higher frequency
  3502.   than 28867 Hz. Therefore you can use this noteplayer to play samples with
  3503.   frequencies above this, with the right speed.
  3504. @ENDNODE
  3505. --------------------------------------------------------------------------------
  3506. @NODE Ahi-cfg
  3507. @TITLE "AHI configuration"
  3508.   @{b}@{u}AHI configuration:@{uu}@{ub}
  3509.   @{b}Change mode & Frequency:@{ub} Opens a requester from which you can
  3510.   select the sound driver and mixing frequency. Use this if want to play
  3511.   using your soundcard.
  3512.   @{b}Support Ping-Pong:@{ub} If you have a lot of cpu power (e.g. at least
  3513.   a 68040) you can have support for Ping-pong loops in samples. If you want
  3514.   it anyhow, just reduce the mixing frequency.
  3515. @ENDNODE
  3516. --------------------------------------------------------------------------------
  3517. @NODE Agents
  3518. @TITLE "Agents"
  3519.   @{u}@{b}Agent Types:@{uu}@{ub}
  3520.   @{b}SampleSavers:@{ub}
  3521.   -------------
  3522.   The sample saver agent will be started when the  user  presses  the  save
  3523.   sample  gadget  in  the  sample  info  window. The agent can then perform
  3524.   certain actions on the chosen sample. If more than one samplesaver  agent
  3525.   is present in the list, the uppermost will be used.
  3526.     @{"Multi" LINK Multi} Converts and saves samples in multiple formats
  3527.   @{b}Scopes:@{ub}
  3528.   -------
  3529.   Scopes are different types of displays that illustrates the modules being
  3530.   played. They may flash, rotate and do all sorts of funky stuff.
  3531.   NB: Only when playing a module whose @{"player" LINK Players} uses a noteplayer, the scopes
  3532.   will be utilized.
  3533.     @{"RGB-box" LINK RGB-box}
  3534.     @{"SpinSquares" LINK SpinSquares}
  3535.     @{"Bar Scope" LINK Barscope}
  3536.     @{"Freq Analyzer" LINK Freqanalyser}
  3537.   @{b}Favourite Song System (FSS):@{ub}
  3538.   ----------------------------
  3539.   Displays a list of the most often heard modules on your computer.
  3540.   @{" Favourite Song System (FSS) " LINK FSS}
  3541. @ENDNODE
  3542. --------------------------------------------------------------------------------
  3543. @NODE multimods
  3544. @TITLE "Multi Sample Formats"
  3545.   @{u}@{b}Sample formats:@{uu}@{ub}
  3546.   @{b}IFF-8SVX@{ub}        : The most normal format in the amiga world. It  supports
  3547.                     8  bit  quality,  mono/stereo  and  fibonacci  packing.
  3548.                     Fibonacci packing will halve the  size  of  the  sample
  3549.                     with nearly no quality loss :)
  3550.                     In the configuration you can  specify the internal name
  3551.                     of the sample and the author name, and whether you want
  3552.                     the sample packed with fibonacci or not.
  3553.                     If the sample is in stereo you have the possibility  to
  3554.                     save  it  as either a mono or a stereo sampling. If you
  3555.                     choose mono, the channels are mixed in 16  bit  quality
  3556.                     and then saved as an 8 bit mono sampling.
  3557.   @{b}IFF-AIFF@{ub}        : This format originates from the Macintosh. It is mostly
  3558.                     used  on  the Macintosh,  but it's also  used by  other
  3559.                     platforms.
  3560.                     This converter supports conversion of 8 and 16 bit AIFF
  3561.                     samples,  mono  or  stereo.  To  see  which conversions
  3562.                     between stereo and mono that are possible see above  in
  3563.                     the IFF-8SVX description.
  3564.                     16 bit samples can be saved in  8  or  16  bit.  8  bit
  3565.                     samples can only be converted in 8 bit.
  3566.                     Like in the IFF-8SVX you can also specify  an  internal
  3567.                     name and author for the sample.
  3568.   @{b}RAW  @{ub}           : This  is  all  files  not covered by  the  above sample
  3569.                     formats. It can be anything from an  executeable  to  a
  3570.                     device  handler.  This is useful if you have some files
  3571.                     which you KNOW are samples but  they  haven't  got  any
  3572.                     header.  In the config you can tell APlayer exactly how
  3573.                     the sample is, and with this informations APlayer  will
  3574.                     create a header for the file.
  3575.                     The things that you have to tell APlayer is:
  3576.                     Quality   : 8 or 16 bit
  3577.                     Endian    : Big (highbyte first),Little (lowbyte first)
  3578.                                 This is pretty technical, only change it if
  3579.                                 nothing else works.
  3580.                     Type      : Signed or unsigned
  3581.                     Channels  : Mono or stereo
  3582.                     Frequency : The samplerate (5000 - 28000).
  3583.   @{b}RIFF-WAVE@{ub}       : This format originates from the PC Windows (Yuk!)
  3584.                     This converter supports conversion of 8 and 16 bit WAVE
  3585.                     samples,  mono  or  stereo.  To  see  which conversions
  3586.                     between stereo and mono that are possible see above  in
  3587.                     the IFF-8SVX description.
  3588.                     16 bit samples can be saved in  8  or  16  bit.  8  bit
  3589.                     samples can only be converted in 8 bit.
  3590.   @{b}Worms@{ub}           : This is our hopefully future famous ...
  3591.                     Tada dada da daaaa! PC-Worms sample bank converter!
  3592.                     Amiga Worms uses separate samples for all the sounds in
  3593.                     the game, like "Fatality", "BlowTorch" and so on ..
  3594.                     PC Worms uses a special form of Sample banks in which
  3595.                     all sounds are stored in one file.
  3596.                     This multi-sample-saver-module can convert those sample
  3597.                     banks to the amiga format.
  3598.                     Instruction:
  3599.                     1.  Open the Configuration/Agents/Multi-SampleSaver
  3600.                         window.
  3601.                     2.  Choose the Worms loader, and the IFF-8SVX saver.
  3602.                     3.  Press the "Convert" button.
  3603.                     4.  From the filerequester you can now choose the PC
  3604.                         sample bank you want to convert.
  3605.                     5.  If it is a real PC sample bank, a window should
  3606.                         appear stating that the format is Worms.
  3607.                     6.  click ok.
  3608.                     7.  Then the IFF-8SVX saver pops up. Simple do @{b}not@{ub}
  3609.                         touch anything here. Just close the window.
  3610.                     8.  Then you are asked for a place to save the converted
  3611.                         sounds, choose that ..
  3612.                     9.  After the sounds has been converted you have to
  3613.                         manually take a few IMPORTANT steps more.
  3614.                     10. If you want all the new samples to be used, copy
  3615.                         them into your TWENGLISH directory in the worms
  3616.                         directory. It is very adviseable to rename the
  3617.                         original directory first!
  3618.                     11. Because the PC-Worms sample banks sometimes lacks
  3619.                         some sounds, you have to copy the missing sounds/
  3620.                         files from your original TWENGLISH directory.
  3621.                         If some files are missing, Worms @{b}will@{ub} most
  3622.                         likely crash!
  3623.                     12. That should be it - "happy, happy - joy, joy" :)
  3624.                         - quote from Richard Richard in "Bottom".
  3625. @ENDNODE
  3626. --------------------------------------------------------------------------------
  3627. @NODE Multi
  3628. @TITLE "SampleSaver - Multi"
  3629.   @{b}@{u}Multi SampleSaver:@{ub}@{uu}
  3630.   This agent can save and convert samples between different @{"sample formats" LINK multimods}.
  3631.   To edit some general  settings  for  the  Multi  SampleSaver,  enter  the
  3632.   @{"configuration window" LINK MultiSampleSaverConfig} belonging to it.
  3633.   @{i}How to Convert a sample:@{ui} Go to the players configuration window and go to
  3634.   the  agent  section.  Select the Multi agent and press the "show" gadget.
  3635.   Then you have the possibility to select which format of  the  sample  you
  3636.   want  to  convert.  If you select automatic, then the agent will find the
  3637.   sample type automatically. Now you have to select the format to which the
  3638.   sample is converted. To convert the sample, press "Convert".
  3639.   Choose the sample to be converted from the filerequester.
  3640.   A window will then popup with some info about the sample:
  3641.   Format   : The format of the sample (e.g. IFF-8SVX or IFF-AIFF)
  3642.   Name     : The internal sample name
  3643.   Author   : The author of the sample
  3644.   length   : The length of the sample without any headers
  3645.   Loop     : Is there a loop in this sample?
  3646.   Rate     : The samplerate in samples/second
  3647.   Channels : The number of channels used in the sampling
  3648.   Quality  : The quality of the sample (e.g. 8 or 16 bit)
  3649.   Type     : Signed, unsigned, fibonacci (delta encoded), ulaw or alaw
  3650.   Endian   : Big (highbyte first), Little (lowbyte first)
  3651.   Press "Okay" and write the filename of the sample you want  to  save.  If
  3652.   the  saver has some settings for you to change, a window will pop up now.
  3653.   To start the conversion just close the window.
  3654.   @{i}How to Save a sample:@{ui} While you are playing a module you select a  sample
  3655.   from  the  sample  info  window.  Press  the save gadget in the top right
  3656.   corner to start the multi sample saver agent. A filerequester will  popup
  3657.   asking you for the name you want to save the sample under. Write the name
  3658.   and press return.
  3659.   Then you can select which format you want to save the sample as.  If  the
  3660.   saver has some configurations for you to change, a window will popup when
  3661.   you press @{b}save@{ub}. If not, the sample will just be saved.
  3662. @ENDNODE
  3663. --------------------------------------------------------------------------------
  3664. @NODE MultiSampleSaverConfig
  3665. @TITLE "Multi SampleSaver Configuration"
  3666.   @{b}@{u}Multi SampleSaver Configuration:@{uu}@{ub}
  3667.   Load Path: This is the default directory where you keep your samples.
  3668.   Save Path: This is the directory where you want your converted samples to
  3669.              be saved to.
  3670.   Xpk packing: Selects wether you want  the converted samples  to be packed
  3671.                with xpk and with which library/packer.
  3672.   Effectiveness: This decides  how good/effective  you want the  chosen xpk
  3673.                  packer to be.
  3674.   Enable Info: Here you can tell  the  information  window  not  to  appear
  3675.                everytime it loads a sample. This is useful if you  want  to
  3676.                convert  a  lot of samples, then you won't have to press the
  3677.                OK gadget in the information window for every new sample.
  3678.                Note that this is only really useful in conjunction with the
  3679.                "Enable Config" switch described below.
  3680.   Enable Cfg: This disables the save configuration  windows for the  sample
  3681.               savers.  If  you  just  want  the  samples  saved  with   the
  3682.               information  APlayer  gets  from  the  sample  you  choose to
  3683.               convert, you can disable the configuration here.
  3684.   Note: The Info and config  windows will only  be disabled if you converts
  3685.         more than one sample. Otherwise they will be opened.
  3686. @ENDNODE
  3687. --------------------------------------------------------------------------------
  3688. @NODE RGB-box
  3689. @TITLE "The RGB-Box Scope Agent"
  3690.   @{b}@{u}RGB-Box Scope:@{ub}@{uu}
  3691.   A window of configurable size consisting of a  square.  The  square  will
  3692.   flash  in  time to the first three tracks of the module being played. Any
  3693.   additional tracks will have no effect on the RGB-box.
  3694.   The colors are chosen so that the first  track  controls  the  red  color
  3695.   value,  the  second  track  the green color value, and the third the blue
  3696.   value. Each note in a given track retrigs the corresponding color  value.
  3697.   The higher the volume, the brighter the color.
  3698. @ENDNODE
  3699. --------------------------------------------------------------------------------
  3700. @NODE SpinSquares
  3701. @TITLE "The Spinning Squares Scope Agent"
  3702.   @{b}@{u}Spinning Squares Scope:@{ub}@{uu}
  3703.   This  agent  consists  of  a  window  divided  into  four  squares,  each
  3704.   containing  its  own  vector-box.  The  box  will  expand and contract in
  3705.   correspondence to the notes being played  in  the  track  it  represents.
  3706.   Factors in deciding the changes are volume and pitch.
  3707.   Configuration  of  this  agent :
  3708.   Rotation : Controls whether the vector-boxes should rotate or not.
  3709.   Double Height: Doubles the height of the scopes. This is  useful  if  you
  3710.   are running APlayer on a 1x1 resolution screen.
  3711.   GfxCard Safety :  When  ON,  disables  multitasking  during  the  drawing
  3712.   routines  to  avoid  the  flickers  that  may  appear  if you are using a
  3713.   Graphics Board that uses the processor in stead of the blitter.
  3714. @ENDNODE
  3715. -------------------------------------------------------------------------------
  3716. @NODE barscope
  3717. @TITLE "The Bar Scope Agent"
  3718.   @{b}@{u}The Bar Scope:@{ub}@{uu}
  3719.   Look at it and see if you can figure out how it works :)
  3720.   A lot of greetings to  Hans Henrik Happe for coding this really wonderful
  3721.   resizeable scope.
  3722. @ENDNODE
  3723. -------------------------------------------------------------------------------
  3724. @NODE FreqAnalyzer
  3725. @TITLE "The Freq Analyzer Scope Agent"
  3726.   @{b}@{u}Freq Analyzer Scope:@{ub}@{uu}
  3727.   This draws a number horizontal lines in a window.  Each  line  symbolizes
  3728.   one channel in the playing module. From left to right the line symbolizes
  3729.   the given octaves of the modules. That is, when a box pops up, the  place
  3730.   where  it  appears  depends on the note being played. The higher the note
  3731.   the more to the right the box is placed. One more thing: The size of each
  3732.   box corresponds to the volume, with which the note was played.
  3733. @ENDNODE
  3734. -------------------------------------------------------------------------------
  3735. @Node Fss
  3736. @TITLE "Favourite Song System"
  3737.   @{u}@{b}Favourite Song System:@{uu}@{ub} (Shortkey f)
  3738.   The Favourite Song System (FSS) is  for  you  who  can't  remember  which
  3739.   modules you like to hear. Okay, that was a bit of a joke! If you add this
  3740.   agent to your agent list, it will automatically store the  names  of  all
  3741.   the  modules  your  have  heard  during  your last run of the APlayer.
  3742.   In addition to that it remembers how many times you have heard  the  same
  3743.   module. All the names are put into a list, from which the FSS-Agent takes
  3744.   a user specified number of played modules and put them into the "Favorite
  3745.   Song System" window. This window displays the top list placements and how
  3746.   many times each module has been played.
  3747.   To control the behaviour of the agent see the @{"FSS-Agent configuration" LINK FSS-config}.
  3748.   When you choose to SHOW the FSS window  you  will  be  presented  with  a
  3749.   window containing a list and some buttons.
  3750.   The list contains the  names of the modules and a number stating how many
  3751.   times each module has been played.
  3752.   If you doubleclick an item in the list it will be added to the bottom  of
  3753.   the module list
  3754.   @{b}RND One:@{ub} This will randomly choose  a module from the list and  add it to
  3755.            the bottom of the module list.
  3756.   @{b}RND All:@{ub} Shuffles all the Top-10 modules and put them in the module list.
  3757.   @{b}Delete:@{ub}  Deletes the marked module from the fss list. The changes will be
  3758.            saved to your fss file the  next time you either quit the player
  3759.            or open the fss window.
  3760.   @{b}Reset:@{ub}   Asks  if you  wants  to clear the  FSS list from  the memory and
  3761.            delete the FSS file on your disk too.
  3762. @ENDNODE
  3763. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  3764. @NODE FSS-Config
  3765. @TITLE "Favourite Song System Configuration"
  3766.   @{b}Favourite Song System Configuration:@{ub}
  3767.   The following options for the FSS Agent can be controlled by you:
  3768.   Save FSS List: Here you decides when and how often the FSS list should be
  3769.                  saved  to  a  file.  None of the possibilities exclude the
  3770.                  others, so you can choose to  save  when  the  FSS  (Show)
  3771.                  window  opens (default), when  it closes  and additionally
  3772.                  you can choose to save the list every x'th minute.
  3773.                  The default is every 15th minute.
  3774.   With the cycle you decides how many, and which, modules you want the list
  3775.   to show to the user.
  3776.   It can be the top 10 (default), top 50, top 100 or top xxx where you type
  3777.   the xxx value to the right of the cycle.
  3778.   Alternatively you can show the worst 10 or worst xxx modules in the list.
  3779.   The FSS Path tells the FSS Agent where to save the FSS list file.
  3780.   @{b}Optimize List:@{ub}
  3781.   This will simply optimize the FSS list. The optimizer will ask you for  a
  3782.   min  hear number which will cause the optimizer to wipe all modules heard
  3783.   less than the specified number of times, from the list.
  3784.   While the program is  building  the  tree,  the  actual  module  will  be
  3785.   displayed. Sometimes it will print them in blue, sometimes in white. When
  3786.   the module name is printed in blue, it means that  the  module  has  been
  3787.   deleted  from  the  tree  because it couldn't find it. If it's printed in
  3788.   white, means it has been deleted from the tree, because  the  hear  count
  3789.   was below the hear number you have given.
  3790.   For a more technical description of this click here .. no @{"here" LINK OptimizeFSS} :)
  3791.   @{b}Convert to APML File:@{ub}
  3792.   This converts your FSS (Favourite Song System) file to an  APML  (APlayer
  3793.   Module  List)  file.  A file requester will pop up to ask you on where to
  3794.   save the APML file.
  3795.   To save, use or  cancel  the  FSS  configuration  use  the  corresponding
  3796.   buttons at the bottom of the window.
  3797. @ENDNODE
  3798. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  3799. @NODE OptimizeFSS
  3800.   @{b}Optimize FSS List:@{ub}
  3801.   As you maybe have guessed, the FSS will store all the  modules  you  have
  3802.   heard  as  a  binary tree. This is because it's the fastest way to search
  3803.   for a file to see if it already exist when you load a new module. If  you
  3804.   know  a  little  bit  about binary trees, you will properly know that the
  3805.   tree will get unbalanced after a while. The term  unbalanced  is  further
  3806.   described in the figures below:
  3807.                                      8
  3808.                                     / \
  3809.                                    3   9
  3810.                                   / \
  3811.                                  2   4
  3812.                                       \
  3813.                                        5
  3814.                            Fig1: Unbalanced Tree
  3815.                                      5
  3816.                                     / \
  3817.                                    3   8
  3818.                                   / \   \
  3819.                                  2   4   9
  3820.                            Fig2: The same tree, but balanced
  3821.   A tree can be divided into two subtrees, from the  root.  The  trees  are
  3822.   split  in  layers,  for  instance  the unbalanced tree in fig.1 has got 4
  3823.   layers, while fig.2 has got 3  layers.  If  a  tree  is  unbalanced  it's
  3824.   because  the  difference  between  the  number  of layers in the two main
  3825.   subtrees is bigger than one.
  3826.   If the tree isn't balanced, it will decrease the search time. Let's  take
  3827.   an example: if you will insert the number 7 in figure 1, you have to test
  3828.   4 other nodes (8, 3, 4 & 5) to know where to place it, but  in  figure  2
  3829.   you  only need 2 tests (5 & 8). Now you can see, the search time has been
  3830.   halfed.
  3831.   This is what this function does, it balances the binary tree (from now on
  3832.   named  AVL-trees).  It will test if the modules are still present on your
  3833.   HD and if they aren't they will be deleted from the  tree.  If  you  have
  3834.   some  modules  on  floppy disk the optimizer asks for the disk. To delete
  3835.   the module from the tree just cancel the disk requesters.
  3836. @ENDNODE
  3837. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  3838. @Font topaz.font 8
  3839. @Node Modtypes
  3840. @Title "Module Types"
  3841.                                                                 |F |
  3842.                                                                 |o |
  3843.                                                                 |r |
  3844.                                                                 |c |
  3845.                                                     |M |S |P |  |e |
  3846.                                                     |a |h |l |  |  |
  3847.                                      |M |           |x |o |a |  |F |  |O |N |
  3848.                                      |o |   *       |  |w |y |A |i |  |w |o |
  3849. +-                                |C |d |  |S |  |P |P |  |  |c |l |  |n |t |
  3850.   +-               |F |           |h |u |  |u |  |o |a |S |S |c |t |F |  |e |
  3851.     +-          |R |o |  |V |     |a |l |A |b |L |s |t |a |a |o |e |a |C |P |
  3852.       +-  Func. |e |r |P |o |  |T |n |e |u |s |e |i |t |m |m |m |r |s |o |l |
  3853.         +-      |w |w |a |l |F |e |n |n |t |o |n |t |e |p |p |p |  |t |n |a |
  3854.           +-    |i |a |u |u |a |m |e |a |h |n |g |i |r |l |l |a |O |m |f |y |
  3855.  Players:   +-  |n |r |s |m |d |p |l |m |o |g |t |o |n |e |e |n |f |e |i |e |
  3856.               +-|d |d |e |e |e |o |s |e |r |s |h |n |s |s |s |y |f |m |g |r |
  3857. ----------------+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
  3858. ActivisionPro   |  |  |X |  |  |X |  |  |  |X |  |  |  |  |  |  |X |  |  |  |
  3859. ArtOfNoise      |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |X |  |X |
  3860. Ben Daglish     |  |  |X |  |  |X |  |  |  |X |  |  |  |  |  |  |X |  |  |  |
  3861. DeliCustom      |  |  |X |  |  |X |  |  |  |X |  |  |  |  |  |  |X |  |  |  |
  3862. Delta10         |  |  |X |X |  |X |  |  |  |  |  |  |  |  |  |  |X |X |  |X |
  3863. Delta20         |  |  |X |X |  |X |  |  |  |  |  |  |  |  |  |  |X |  |  |  |
  3864. DigiBooster     |X |X |X |X |  |  |  |X |X |  |X |X |X |X |X |  |  |  |  |  |
  3865. DigitalMugician |X |X |X |X |X |X |  |X |  |X |X |X |X |  |  |  |X |  |  |  |
  3866. DSS             |X |X |X |X |X |X |X |  |X |  |X |X |X |X |X |  |X |  |  |  |
  3867. FastTracker     |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |X |  |X |
  3868. FastTracker20   |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |X |  |X |
  3869. Fred            |  |  |X |X |  |X |X |  |  |X |  |  |  |  |  |  |X |  |  |  |
  3870. Future13        |X |X |X |X |  |X |X |  |  |  |X |X |  |  |  |  |X |X |  |X |
  3871. Future14        |X |X |X |X |  |X |X |  |X |  |X |X |  |X |X |X |X |X |  |X |
  3872. Hippel          |  |  |X |  |  |X |  |  |X |X |  |  |  |  |  |  |X |  |  |  |
  3873. IFF-8SVX        |  |X |X |X |  |X |X |X |X |  |X |X |  |  |  |  |  |X |@{"X" link iffcfg}|X |
  3874. IFF-AIFF        |  |  |  |X |  |X |  |X |X |  |X |X |  |  |  |  |X |  |@{"X" link aiffcfg}|X |
  3875. IFF-SMUS        |  |  |X |X |  |X |X |X |X |  |  |  |  |  |  |  |X |  |@{"X" link smuscfg}|  |
  3876. ImpulseTracker  |X |X |X |X |  |X |X |X |  |  |X |X |  |  |  |  |X |X |  |X |
  3877. InStereo2.0     |X |X |X |X |  |X |X |X |  |X |X |X |  |X |  |  |X |X |  |X |
  3878. JamCracker      |X |X |X |X |X |X |X |  |X |  |X |X |X |X |X |X |X |X |  |X |
  3879. JCBrooke        |  |  |X |  |  |X |  |  |X |X |  |  |  |  |  |  |X |  |  |  |
  3880. MarkCooksey     |  |  |X |  |  |X |  |  |X |X |  |  |  |  |  |  |X |  |  |  |
  3881. MarkII          |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
  3882. MED             |X |X |X |X |  |  |X |  |X |X |X |X |X |X |X |X |X |X |  |X |
  3883. MON             |  |  |X |  |  |X |  |  |  |X |  |  |  |  |  |  |X |  |  |  |
  3884. MultiTracker    |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |X |  |X |
  3885. MusicAss        |  |  |X |X |  |X |X |  |  |X |  |  |  |  |  |  |X |X |  |X |
  3886. MusicLine       |  |  |X |X |  |  |  |  |  |X |  |  |  |  |  |  |  |X |  |  |
  3887. NoisePacker20   |X |X |X |X |X |X |  |  |  |  |X |X |X |  |  |  |X |  |  |  |
  3888. NoisePacker30   |X |X |X |X |X |X |  |  |  |  |X |X |X |  |  |  |X |  |  |  |
  3889. NoiseTracker    |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |X |  |X |
  3890. OctaMed         |X |X |X |  |  |  |  |  |X |X |X |X |X |X |X |  |  |  |  |X |
  3891. OctaMedSS       |X |X |X |  |  |  |  |  |X |X |X |X |X |X |  |  |  |X |X |  |
  3892. Oktalyzer       |X |X |X |X |X |X |X |  |X |  |X |X |X |X |X |X |X |X |  |X |
  3893. ProTracker      |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |X |  |X |
  3894. PumaTracker     |X |X |X |X |X |X |X |X |  |  |X |X |X |  |  |  |X |  |  |  |
  3895. QuadraComposer  |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |X |  |X |
  3896. RIFF-WAVE       |  |X |X |X |  |X |X |  |  |  |X |X |  |  |  |  |X |X |@{"X" link riffcfg}|X |
  3897. RonKlaren       |  |  |X |  |  |X |  |  |  |X |  |  |  |  |  |  |X |  |  |  |
  3898. ScreamTracker30 |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |X |  |X |
  3899. SID             |X |X |X |  |  |  |X |X |X |X |  |  |  |  |  |  |  |  |@{"X" link sidcfg}|  |
  3900. SidMon10        |X |X |X |X |  |X |  |  |  |  |X |X |  |  |  |  |X |  |  |  |
  3901. SidMon20        |X |X |X |X |X |X |X |  |  |  |X |X |  |  |  |  |X |X |  |X |
  3902. SoundFactory    |  |  |X |X |  |X |X |  |  |X |  |  |  |  |  |  |X |X |  |X |
  3903. SoundFX13       |X |X |X |X |X |X |X |  |X |  |X |X |X |X |X |X |X |X |  |X |
  3904. SoundFX20       |X |X |X |X |X |X |X |  |X |  |X |X |X |X |X |X |X |X |  |X |
  3905. SoundMon20      |X |X |X |X |  |X |X |X |  |  |X |X |X |  |  |  |X |X |  |X |
  3906. SoundTracker15  |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |X |  |X |
  3907. SoundTracker31  |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |X |  |X |
  3908. StarTrekker4    |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |  |  |  |
  3909. StarTrekker4AM  |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |  |  |  |
  3910. Syntracker      |X |X |X |X |X |X |X |  |X |  |X |X |X |X |X |X |X |X |  |X |
  3911. TFMX_15         |X |X |X |X |  |X |  |  |X |X |X |X |  |  |  |  |X |  |  |  |
  3912. THX             |X |X |X |X |  |X |  |X |  |X |X |X |  |  |  |  |X |  |  |  |
  3913. TronicTracker   |X |X |X |X |  |X |X |  |  |  |X |X |  |  |  |  |X |  |  |  |
  3914. Whittaker       |  |  |X |X |  |X |X |  |X |X |  |  |  |  |  |  |X |  |  |  |
  3915. ----------------+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
  3916. Get a more thorough player description @{"here" LINK plcyc}.
  3917. * For further info, see @{"Tunes" LINK tunes}.
  3918. Excluded since APlayer version 2.11:
  3919. ------------------------------------
  3920. ActionAmics     |X |X |X |X |  |X |X |  |X |X |X |X |  |X |X |X |X |  |  |  |
  3921. FTM             |  |  |X |X |  |  |  |X |X |  |X |X |  |  |  |  |  |  |  |  |
  3922. Hippel-COSO     |  |  |X |X |  |X |  |  |X |X |X |X |  |X |X |  |X |X |  |X |
  3923. Hippel-7V       |  |  |X |X |  |X |  |  |X |X |X |X |  |X |X |  |X |X |  |X |
  3924. InStereo!       |X |X |X |X |  |X |X |X |  |X |X |X |  |  |  |  |X |  |  |  |
  3925. MajorTom        |X |X |X |X |X |X |  |  |  |  |X |X |X |  |  |  |X |  |  |  |
  3926. SonicArranger   |X |X |X |X |  |X |X |  |X |X |X |X |  |X |X |X |X |  |  |  |
  3927. SoundControl    |X |X |X |X |  |X |X |X |  |  |X |X |  |  |  |  |X |  |  |  |
  3928. SoundMon22      |X |X |X |X |  |X |X |X |  |  |X |X |X |  |  |  |X |X |  |X |
  3929. Synthesis       |X |X |X |X |  |X |  |X |  |X |X |X |  |  |  |  |X |  |  |  |
  3930. TFMX            |X |X |X |X |  |  |  |  |X |X |X |X |  |  |  |  |  |X |  |X |
  3931. TimFolin        |  |  |X |X |  |X |X |  |X |X |  |  |  |  |  |  |X |X |  |X |
  3932. TME             |X |X |X |X |X |X |X |X |X |X |X |X |  |X |X |X |X |  |  |  |
  3933. VectorDean      |  |  |X |X |  |X |  |  |  |X |  |  |  |  |  |  |X |X |  |X |
  3934. VSS             |  |  |X |X |  |X |  |  |  |  |  |  |  |  |  |  |X |  |  |  |
  3935. @ENDNODE
  3936. --------------------------------------------------------------------------------
  3937. @Font screenfont 8
  3938. @NODE iffcfg
  3939. @TITLE "IFF-8SVX Configuration"
  3940.   @{u}@{b}IFF-8SVX Config:@{ub}@{uu}
  3941.   The IFF-8SVX player works by loading a  sample  bit  by  bit  (buffer  by
  3942.   buffer)  and  play  it. As user you can define how big each buffer should
  3943.   be and how much memory that should be used at maximum.
  3944.   @{b}Load buffer size in Kb:@{ub} The size of each load buffer. Please note that if
  3945.   you want a buffer size of e.g. 64 Kb and you try to load a 20 Kb  sample,
  3946.   then  the  player  will  allocate  a 64 Kb buffer. That is, no matter how
  3947.   small or large your sample is, only whole buffers will be allocated. e.g.
  3948.   a 75 Kb sample will need for instance two 64 Kb buffers.
  3949.   Note1: If you play stereo samples the buffer size will be doubled.
  3950.   Note2: Fibonacci packed samples will use an extra buffer,  sized  half of
  3951.   the load buffer size, for depacking.
  3952.   @{b}Max memory to use in Kb:@{ub} The maximum amount of memory to be used for load
  3953.   buffers. This number should at least be six times the size  of  the  load
  3954.   buffer size (because of double buffering and stereo). If you haven't  got
  3955.   enough  free  memory to allocate 6 times the size of the load buffer, the
  3956.   playback of the sample can get corrupted.
  3957.   Obs: If your harddisk have problems keeping up with  loading  the  sample
  3958.   buffers, it might help to increase the buffer size.
  3959.   @{b}Play only once:@{ub} This  will  tell APlayer only to play the sample once, no
  3960.   matter how big it is.
  3961. @ENDNODE
  3962. --------------------------------------------------------------------------------
  3963. @NODE aiffcfg
  3964. @TITLE "IFF-AIFF Configuration"
  3965.   @{u}@{b}IFF-AIFF Config:@{ub}@{uu}
  3966.   The IFF-AIFF player works by loading a  sample  bit  by  bit  (buffer  by
  3967.   buffer)  and  play  it. As user you can define how big each buffer should
  3968.   be and how much memory that should be used at maximum.
  3969.   @{b}Load buffer size in Kb:@{ub} The size of each load buffer. Please note that if
  3970.   you want a buffer size of e.g. 64 Kb and you try to load a 20 Kb  sample,
  3971.   then  the  player  will  allocate  a 64 Kb buffer. That is, no matter how
  3972.   small or large your sample is, only whole buffers will be allocated. e.g.
  3973.   a 75 Kb sample will need for instance two 64 Kb buffers.
  3974.   Note1: If you play stereo samples the buffer size will be doubled.
  3975.   @{b}Max memory to use in Kb:@{ub} The maximum amount of memory to be used for load
  3976.   buffers. This number should at least be six times the size  of  the  load
  3977.   buffer size (because of double buffering and stereo). If you haven't  got
  3978.   enough  free  memory to allocate 6 times the size of the load buffer, the
  3979.   playback of the sample can get corrupted.
  3980.   Obs: If your harddisk have problems keeping up with  loading  the  sample
  3981.   buffers, it might help to increase the buffer size.
  3982.   @{b}Play only once:@{ub} This  will tell APlayer only to play the sample  once, no
  3983.   matter how big it is.
  3984. @ENDNODE
  3985. --------------------------------------------------------------------------------
  3986. @NODE ocsscfg
  3987. @TITLE "OctaMED Sound Studio Configuration"
  3988.   @{u}@{b}OctaMED Sound Studio Config:@{ub}@{uu}
  3989.   @{b}14 Bit:@{ub} Toggles wether the 14 bit play or the 8 bit routine
  3990.   should be used. 14 bit generally gives you better but lower sound.
  3991.   @{b}Frequency:@{ub} Adjust the mixing frequency. The higher the more CPU
  3992.   demanding ..
  3993. @ENDNODE
  3994. --------------------------------------------------------------------------------
  3995. @NODE riffcfg
  3996. @TITLE "RIFF-WAVE Configuration"
  3997.   @{u}@{b}RIFF-WAVE Config:@{ub}@{uu}
  3998.   The RIFF-WAVE player works by loading a  sample  bit  by  bit  (buffer by
  3999.   buffer)  and  play  it. As user you can define how big each buffer should
  4000.   be and how much memory that should be used at maximum.
  4001.   @{b}Load buffer size in Kb:@{ub} The size of each load buffer. Please note that if
  4002.   you want a buffer size of e.g. 64 Kb and you try to load a 20 Kb  sample,
  4003.   then  the  player  will  allocate  a 64 Kb buffer. That is, no matter how
  4004.   small or large your sample is, only whole buffers will be allocated. e.g.
  4005.   a 75 Kb sample will need for instance two 64 Kb buffers.
  4006.   Note1: If you play stereo samples the buffer size will be doubled.
  4007.   @{b}Max memory to use in Kb:@{ub} The maximum amount of memory to be used for load
  4008.   buffers. This number should at least be six times the size  of  the  load
  4009.   buffer size (because of double buffering and stereo). If you haven't  got
  4010.   enough  free  memory to allocate 6 times the size of the load buffer, the
  4011.   playback of the sample can get corrupted.
  4012.   Obs: If your harddisk have problems keeping up with  loading  the  sample
  4013.   buffers, it might help to increase the buffer size.
  4014.   @{b}Play only once:@{ub} This  will tell APlayer only to  play the sample once, no
  4015.   matter how big it is.
  4016. @ENDNODE
  4017. --------------------------------------------------------------------------------
  4018. @NODE sidcfg
  4019. @TITLE "SID Configuration"
  4020.   @{u}@{b}SID Config:@{ub}@{uu}
  4021.   @{b}Use Rewind Buffers:@{ub} If you  want to be able  to use  rewind when  you are
  4022.   playing SID modules, then check this ON.
  4023.   @{b}Warning: This uses  a lot of memory  (approximately 0.5 kb/sec), so don't
  4024.   use it if you can't live without the memory!@{ub}
  4025.   @{b}Rewind Speed:@{ub} This slider is used to decide how much the tune  should  be
  4026.   rewound  every time you push the  rewind button. (For advanced users: The
  4027.   amount is the number of frames that should be rewound).
  4028.   @{b}Forward Speed:@{ub} This slider is used to decide how much the tune should  be
  4029.   forwarded  every time you push  the forward  button. (For advanced users:
  4030.   The amount is the number of frames that should be forwarded).
  4031.   I love copying text frames... :-)
  4032. @ENDNODE
  4033. --------------------------------------------------------------------------------
  4034. @NODE smuscfg
  4035. @TITLE "IFF-SMUS Configuration"
  4036.   @{u}@{b}IFF-SMUS Config:@{ub}@{uu}
  4037.   @{b}Instrument Path:@{ub} The full path  or an assign name  to the place where the
  4038.   instruments for your SMUS modules are to be found. The path can be chosen
  4039.   by pressing the diskgadget to the right of the string gadget.
  4040. @ENDNODE
  4041. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  4042. -------------------------------------------------------------------------------
  4043. @NODE cfgsaveusecancel
  4044. @TITLE "Configuration - Save/Use/Cancel"
  4045.   @{b}Save   :@{ub} This  will  save the preferencefiles in both ENV:APlayer/ and in
  4046.            your  ENVARC:APlayer/  directory.  It will also close the config
  4047.            window.
  4048.   @{b}Use    :@{ub} Pressing  this will save the preferencefiles in ENV:APlayer/ and
  4049.            close the configuration window.
  4050.   @{b}Cancel :@{ub} This  will close the config window and  restore your preferences
  4051.            as they were before the config window was opened.
  4052.   @{b}Among@{ub} all the settings saved in the prefs file is the state of  the  main
  4053.   window  cycle,  module  loop,  sound  channels  and  the speed and volume
  4054.   settings.
  4055. @ENDNODE
  4056. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  4057. -------------------------------------------------------------------------------
  4058. @NODE INDEXNODE "Index"
  4059.  @{b}APlayer Index:@{ub}
  4060.  @{b}<Numeric>@{ub}
  4061.  @{"14 Bit Stereo 2Voices configuration" LINK 2config}
  4062.  @{"32 Voices Configuration" LINK 32config}
  4063.  @{b}A@{ub}
  4064.  @{"About Window" LINK About}
  4065.  @{"Activate ARexx" LINK ActivateARexx}
  4066.  @{"Add Item, Players/Noteplayers/Agents" LINK plcfgAdd}
  4067.  @{"Adjust Speed" LINK Speed}
  4068.  @{"Adjust Volume" LINK Volume}
  4069.  @{"Agents" LINK Agents}
  4070.  @{"AHI config" LINK AHI-cfg}
  4071.  @{"Allocate Channels" LINK AllocateChannels}
  4072.  @{"APML Path" LINK APMLpath}
  4073.  @{"App Popup/Hide Hotkey" LINK apppopup}
  4074.  @{"App-Icon" LINK App-icon}
  4075.  @{"AppIcon Configuration" LINK cfgAppIcon}
  4076.  @{"ARexx Configuration" LINK cfgARexx}
  4077.  @{"ARexx Macros" LINK F1}
  4078.  @{"ARexx Qualifier" LINK ARexxCycle}
  4079.  @{b}B@{ub}
  4080.  @{"Bar Scope Agent" LINK barscope}
  4081.  @{b}C@{ub}
  4082.  @{"Cancel Player/Noteplayer/Agent Configuration" LINK plcfgCancel}
  4083.  @{"Clear List, Players/Noteplayers/Agents" LINK plcfgClear}
  4084.  @{"CLI arguments.." LINK Tooltypes}
  4085.  @{"Config Hotkeys" LINK hotkeyconfiglist}
  4086.  @{"Config, Players/Noteplayers/Agents" LINK plcfgConfig}
  4087.  @{"Configuration - Save/Use/Cancel" LINK cfgsaveusecancel}
  4088.  @{"Configuration Menu" LINK prefsmenu}
  4089.  @{"Configuration Window" LINK cfg}
  4090.  @{"Contact addresses" LINK contact}
  4091.  @{"Copyright information and rules of distribution" LINK Disclaimer}
  4092.  @{"Cut Prefixes" LINK CutPrefixes}
  4093.  @{b}D@{ub}
  4094.  @{"Default Screen" LINK Defaultscreen}
  4095.  @{"Delete Item, Players/Noteplayers/Agents" LINK plcfgDelete}
  4096.  @{"Double Buffering" LINK DoubleBuffering}
  4097.  @{b}E@{ub}
  4098.  @{"Early Load" LINK EarlyLoad}
  4099.  @{"Eject module" LINK Eject}
  4100.  @{"End of modulelist" LINK EndModulelist}
  4101.  @{"Error Messages" LINK ErrorMessages}
  4102.  @{"Exchange Items, Players/Noteplayers/Agents" LINK plcfgExchange}
  4103.  @{"Expunge Libraries" LINK ExpungeLibraries}
  4104.  @{"Extract Pattern" LINK extractpattern}
  4105.  @{b}F@{ub}
  4106.  @{"Fade At Pause/Next" LINK FadeatPause}
  4107.  @{"Fade Module At End" LINK FademoduleatEnd}
  4108.  @{"Fade Speed" LINK FadeSpeed}
  4109.  @{"Fast Forward" LINK FF}
  4110.  @{"Favourite Song System Configuration" LINK FSS-Config}
  4111.  @{"Favourite Song System" LINK Fss}
  4112.  @{"File Requester" LINK DISK}
  4113.  @{"Force Filter Off" LINK ForceFilteroff}
  4114.  @{b}G@{ub}
  4115.  @{"General Font" LINK GeneralFont}
  4116.  @{b}H@{ub}
  4117.  @{"Hard'n'soft-ware requirements" LINK Requirements}
  4118.  @{"History of AccessiblePlayer" LINK History}
  4119.  @{"Hotkey Definition" LINK Hotkey}
  4120.  @{"Hotkey To Skip Module" LINK skiphotkey}
  4121.  @{"Hotkeys Configuration" LINK cfgHotkeys}
  4122.  @{"How to use AccessiblePlayer" LINK Usage}
  4123.  @{b}I@{ub}
  4124.  @{"Iconify AccessiblePlayer" LINK Icn}
  4125.  @{"IFF-8SVX Configuration" LINK iffcfg}
  4126.  @{"IFF-AIFF Configuration" LINK aiffcfg}
  4127.  @{"IFF-SMUS Configuration" LINK smuscfg}
  4128.  @{"Index" LINK INDEX}
  4129.  @{"Installing the AccessiblePlayer" LINK Installation}
  4130.  @{"Introduction to AccessiblePlayer" LINK Introduction}
  4131.  @{"Item Up/Down" LINK plcfgArrowupdown}
  4132.  @{b}J@{ub}
  4133.  @{"Jump To added Module" LINK Jumptoaddedmodule}
  4134.  @{b}K@{ub}
  4135.  @{"Keyboard control keys" LINK keyboard}
  4136.  @{b}L@{ub}
  4137.  @{"List Font" LINK Listfont}
  4138.  @{"List Selector" LINK plcyc}
  4139.  @{"ListView Control" LINK listview}
  4140.  @{"Load Libraries" LINK LoadLibraries}
  4141.  @{"Loop Active Module" LINK Loop}
  4142.  @{b}M@{ub}
  4143.  @{"Main window cycle" LINK Maincyc}
  4144.  @{"Main window list" LINK MainListview}
  4145.  @{"Main window list Scroller" LINK Scroll}
  4146.  @{"Module list Editor" LINK ML}
  4147.  @{"Module list" LINK modlist}
  4148.  @{"Module Path" LINK modulepath}
  4149.  @{"Module Types" LINK Modtypes}
  4150.  @{"ModulePattern" LINK Modulepattern}
  4151.  @{"Multi Sample Formats" LINK multimods}
  4152.  @{"Multi SampleSaver Configuration" LINK MultiSampleSaverConfig}
  4153.  @{b}N@{ub}
  4154.  @{"Never Ending Module Timeout Value" LINK timeoutvalue}
  4155.  @{"Never Ending Module Timeout" LINK Timeout}
  4156.  @{"Next module" LINK Next}
  4157.  @{"Noteplayer, 1st priority" LINK plcfgquestionmark}
  4158.  @{"NotePlayers" LINK NotePlayers}
  4159.  @{"Numeric Keypad" LINK Keypad}
  4160.  @{b}O@{ub}
  4161.  @{"OctaMED Sound Studio Configuration" LINK ocsscfg}
  4162.  @{"Online Help" LINK OnlineHelp}
  4163.  @{"Optimize FSS List" LINK OptimizeFSS}
  4164.  @{"Options Configuration Page 1" LINK cfgOptions}
  4165.  @{"Options Configuration Page 2" LINK cfgoptions2}
  4166.  @{b}P@{ub}
  4167.  @{"Paths Configuration" LINK cfgPaths}
  4168.  @{"Pause module" LINK Pause}
  4169.  @{"Play" LINK Play}
  4170.  @{"Players" LINK players}
  4171.  @{"Players/Noteplayers/Agents Configuration" LINK cfgplayers}
  4172.  @{"Players/Noteplayers/Agents List" LINK plcfgplayerlist}
  4173.  @{"Popup/Hide Hotkey" LINK popuphide}
  4174.  @{"Previous Module" LINK Prev}
  4175.  @{b}R@{ub}
  4176.  @{"Rewind" LINK Rew}
  4177.  @{"RGB-Box Scope Agent" LINK RGB-box}
  4178.  @{"RIFF-WAVE Configuration" LINK riffcfg}
  4179.  @{b}S@{ub}
  4180.  @{"Sample info window" LINK SampleInfo}
  4181.  @{"SampleSaver - Multi" LINK Multi}
  4182.  @{"Save Player/Noteplayer/Agent Configuration" LINK plcfgSave}
  4183.  @{"Save Window Positions" LINK Savewindowpositions}
  4184.  @{"Screen List" LINK Screens}
  4185.  @{"Shareware Notice" LINK Shareware}
  4186.  @{"Show Hotkeys" LINK hotkeyshowlist}
  4187.  @{"Show, Players/Noteplayers/Agents" LINK plcfgShow}
  4188.  @{"Shuffle Modulelist" LINK Shuffle}
  4189.  @{"SID Configuration" LINK sidcfg}
  4190.  @{"Sort Items, Players/Noteplayers/Agents" LINK plcfgSort}
  4191.  @{"Sound Channels" LINK 1}
  4192.  @{"Speed Reset" LINK Sreset}
  4193.  @{"Spinning Squares Scope Agent" LINK SpinSquares}
  4194.  @{"Start Scan Path" LINK startscanpath}
  4195.  @{"Statements" LINK Statements}
  4196.  @{"Status bar" LINK Status}
  4197.  @{"Sub pages" LINK cfgPages}
  4198.  @{b}T@{ub}
  4199.  @{"Temp Path" LINK Temppath}
  4200.  @{"Thanks" LINK Thanks}
  4201.  @{"The Featurelist of AccessiblePlayer" LINK Features}
  4202.  @{"The Future of APlayer" LINK Future}
  4203.  @{"Tip of The Day" LINK Tipoftheday}
  4204.  @{"Tooltypes" LINK Tooltypes}
  4205.  @{"Tunes" LINK tunes}
  4206.  @{b}U@{ub}
  4207.  @{"Unpack Arguments" LINK Unpackarguments}
  4208.  @{"Unpack Check Pattern" LINK checkpattern}
  4209.  @{"Unpack Configuration" LINK cfgunpack}
  4210.  @{"Unpack Lha" LINK unpacklha}
  4211.  @{"Unpack Library" LINK unpacklibrary}
  4212.  @{"Unpack Lzx" LINK unpacklzx}
  4213.  @{"Unpack Path" LINK Unpackpath}
  4214.  @{"Update Lists" LINK Updatelists}
  4215.  @{"Use Player/Noteplayer/Agent Configuration" LINK plcfgUse}
  4216.  @{"Used Hotkeys" LINK usedhotkeyslist}
  4217.  @{b}V@{ub}
  4218.  @{"VBlank Interrupt" LINK VBlankInterrupt}
  4219.  @{"Version" LINK plcfgversion}
  4220.  @{"Volume Reset" LINK Volreset}
  4221.  @{b}W@{ub}
  4222.  @{"Why requesters" LINK why}
  4223.  @{"Windows/Screens Configuration" LINK cfgwindowsscreens}
  4224.  @{b}ARexx Links:@{ub}
  4225.  @{"ARexx" LINK ArexxMain}
  4226.  @{"Channels" LINK ARChannel}
  4227.  @{"Eject" LINK AReject}
  4228.  @{"LOOP" LINK ARLOOP}
  4229.  @{"MainCycle" LINK ARMAINCYCLE}
  4230.  @{"ModuleList" LINK ARMODULELIST}
  4231.  @{"Pause" LINK ARPAUSE}
  4232.  @{"Play" LINK ARPLAY}
  4233.  @{"Requester" LINK ARRequester}
  4234.  @{"Sample" LINK ARsample}
  4235.  @{"Speed" LINK ARSpeed}
  4236.  @{"Technical" LINK ARTechnical}
  4237.  @{"Various" LINK ARvarious}
  4238.  @{"Volume" LINK ARVolume}
  4239.  @{"Window" LINK ARWindow}
  4240. @ENDNODE
  4241. @NODE why
  4242. @TITLE "Why requesters"
  4243.   If you get an error requester  from  APlayer, and  you  don't  understand
  4244.   what's  going on, press the @{b}WHY@{ub} gadget in the requester. This gives you a
  4245.   brief description of the error, and suggestions on how to correct it.
  4246. @ENDNODE
  4247.